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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-51S5  ( I CAM  Projeot  6201).  This 
oontract  is  sponsored  by  the  Materials  Laboratory.  Air  Foroe 
Systens  Coanand,  Wright-Pat torson  Air  Foroe  Base.  Ohio.  It  was 
adninistered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shunaker .  I CAM  Progran  Manager.  Manufacturing  Technology 
Division,  through  Project  Manager.  Mr.  David  Judson.  The  Prine 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Coapany.  Schenectady.  Mew  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Autonation  Systeas  Departaent. 
Albany.  Mew  York. 

Certain  work  aiaed  at  iaproving  Test  Bed  Technology  has 
been  perforaed  by  other  contracts  with  Project  6201  perforning 
integrating  functions.  This  work  consisted  of  enhanoenents  to 
Test  Bed  software  and  establishaent  and  operation  of  Test  Bed 
hardware  and  coanuni cat ions  for  developers  and  other  users. 
Docuaentation  relating  to  the  Test  Bed  froa  all  of  these 
contractors  and  projects  have  been  integrated  un<\e?  Project  6201 
for  publication  and  treataent  as  an  integrated  set  of  docuaents . 
The  particular  contributors  to  each  doouaent  are  noted  on  the 
Report  Docuaentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  docuaentation  sy6tea  and  how  they  are 
related  is  contained  in  docuaent  FTR62 01 00001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors  Role 

Boeing  Military  Aircraft  Reviewer. 

Coapany  ( BMAC ) 

D.  Appleton  Company  Responsible  for  IDEF  support. 

(DACOM)  state-of-the-art  literature 

search . 

Responsible  for  factory  view 
function  and  inforaation 
models . 


General  Dynamics/ 
Ft.  Worth 
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Illinois  Institute  of 
Technology 


■orth  American  Rookve 1 1 
Sort hr op  Corporation 


Pritskor  and  Associates 
SofTooh 


Solo 

Responsible  for  factory  view 
function  researoh  (IITRI) 
and  lnfornation  node Is  of 
snail  and  nediun-sise  business. 

Reviewer . 

Responsible  for  factory  view 
function  and  information 
models . 

Responsible  for  IDEP2  support. 
Responsible  for  IDEPO  support. 


TASKS  4.S  -  4.9  (TEST  BED: 


Subcontractors 


Role 


Boeing  Military  Aircraft  Responsible  for  consultation  on 
Company  (BMAC)  applications  of  the  technology 

and  on  IBM  oonputer  technology. 


Computer  Technology  Assisted  in  the  areas  of 

Associates  (CTA)  communications  systems,  system 

design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 


Control  Data  Corporation  Responsible  for  the  Common  Data 
(CDC)  Model  (CDM)  implementation  and 

part  of  the  CDM  design  (shared 
with  DAOOM). 


D.  Appleton  Company  Responsible  for  the  overall  CDM 

(DACOM)  Subsystem  design  integration 

and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DAOOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 
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Subcontractors 

Digital  Equipment 
Corporation  (DSC) 


McDonnell  Douglas 
Autoaation  Company 
(MoAuto) 


On-Line  Software 
International  (OSI) 


Role 

Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  oonputer  systens 
operation. 

Responsible  for  the  support  and 
enhancenents  to  the  Network 
Transaction  Manager  Subsystea 
during  1984/1985  period. 

Responsible  for  prograaaing  the 
Coununi oat ions  Subsystea  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systeas 
Products  (RSSP)  (In  1985 
becaae  McCoraack  0  Dodge) 


SofTech .  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  iaplementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
iaplementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems . 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Fed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
( BMAC) 


1701 ,  2201 .  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC ) . 


v 
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Contractor* 


I  CAW  Pro.leot  Contributing  Activities 


Control  Data 
Corporation  (CDC) 


1502,  1701  IZSS  enhancements  to 
Common  Data  Model 
Processor  (CDMP). 


D.  Appleton  Company 
(DACOM) 

General  Electric 


Hughes  Aircraft 
Company  (KAC) 

Structural  Dynamics 
Research  Corporation 
(SDRC) 


Systran 


1502 

1502 


1701 


IISS  enhancements  to 
Integration  Methodology 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Test  Bed  enhancements . 


1502,  1701, 
1703 

1502 


IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
(UI/VTI ) . 

Test  Bed  enhancements . 
Operation  of  Test  Bed. 
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SECTION  1 
SCOPE 


1 . 1  Iden t i  f  i cat 1 on 

This  specification  establishes  the  'as  built'  design  of  the 
Software  Services  component  of  the  Network  Transaction  Manager 
Subsystem. 

1 .2  Functional  Summary 

The  Network  Transaction  Manager  (NTM)  Subsystem  provides 
the  control  and  support  services  to  applcation  processes  that 
are  grouped  together  logically  in  clusters  called  Application 
Process  Cluster  (APCs).  These  application  processes  communicate 
with  one  another  by  sending  messages  via  the  NTM.  The  NTM 
deliver*  these  messages  to  the  destination  application  processes 
while  also  providing  other  services  for  the  APs  such  as  message 
pairing.  AP  initiation,  and  message  queuing. 
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i 


SECT I OP  2  | 

DOCUMEMTS  j 

i 

j 

2 . 1  Reference  Documents  I 

The  following  pertinent  reference  materials  are  available 
at  the  I CAM  Program  Office. 


1.  Interin  Reports 

2.  Life  Cycle  Documents 

(a)  ITR620 1500020  Project  Scope 

(b)  PMP620150000  Master  Plan  and  Schedule 

(c)  SAD620 150000  State-of -the-Art  Review 

(d)  SRD620 140000  System  Requirements  Document 

(e)  SDS620 140000  System  Design  Specifications 

(f)  DS620 1420000  Development  Specification  - 
Network  Transaction  Manager  Subsystem 


The  following  reference  materials  are  available  from 
Digital  Equipment  Corporation. 

(a)  VAX /VMS  I/O  User ' s  Guide  (Volume  1),  Order 
No . AA-M540B-TE 

( b )  VAX /VMS  I/O  User  * s  Guide  (Volume  2 ) .  Order 
No . AA-M541B-TE 

( c )  VAX  COBOL  Language  Reference  Manual ,  Order 
No . AA-H631C-TE 

(d)  VAX-1 1  FORTRAN  Language  Reference  Manual , 
OrderNo.  AA-D034C-TE 

Other  reference  materials  are  as  follows. 


(a)  International  Organisation  for 

Standardi sat ion. Open  Systems  Interconnection, 


1 


rt  030142300 
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Inf  or— t  Ion  ProotHif  iTit—  -  I—  lc  Nfgrgct 
Modal.  t6~97/16  ■  710 

(b)  Intor— tto— 1  Organ  i  —  lion  for 

Standard  i  — 1  i  on .  Op—  Syc  tans  Intarcoaaact  i  oa 
Draft.  Conn action  -Or I—  tod  Transport  iarvioa 
Daf ini t ion  TC  07/ 16  I  100 

(c)  Intor— tio—  1  Orfan i—  tim  for  Btanuardi  —  t j on 
Opon  Syst— s  Intorco— act  l  oa  .  Draft. 

Conanc  1 1 on -Or l on  tad  Transport  Protocol 
Specif ioat ion  Varslon  12.  TC  97  >  16  I  86 1 

(d)  Intar— tio— 1  Orfan  1  sat i on  for  Standardisation 
Open  Syst— s  Intarcon—ctioa .  Draft 

Co— act  ion -Orion  tad  Boss  ion  Protocol  Daf  i  n  1 1 1  on 
TC  07/16  I  8S6 

(e)  Mat  1 o—l  Bureau  of  Standards.  Specification  of 
the  Transport  Protocol .  Volune  2  Basic 

Cl— s  Protocol .  Draft  Report .  September  1M1  . 
Report  Mo.  ICST/RLVP-S 1 -12 

(f)  Ratio— 1  Bur— u  of  Standards.  Specification  of 
the  Tran sport  Protocol .  Volume  3  Extended 
Class  Protocol .  Draft  Report .  Saptaaber  10® 1 . 
Report  Bo.  ICST/HLBP-81 -IS 

( g )  Rational  Bureau  of  Standards,  Specification  of 
the  Transport  Protocol .  Volune  4 :  network 
Interfaces .  Draft  Report.  September  1981.  Report 
Ho.  ICST/HLHP-81 - 14 


2 . 2  Terns  And  Abbreviations 

1 .  Interhost  Co— uni  cat  ion  Primitives  ( IHC ' s )  -  A  set  of 
routines  used  by  the  NTM  to  interface  to  the  operating 
system  or  to  other  operating  systens  which  have  an  NTM 
running.  They  are  always  system  dependent. 

2.  Interprocess  Co— uni  cat  i  on  Primitives  ( I  PC '  s )  -  A  set 
of  routines  used  to  co— uni  cate  between  two  processes 
on  the  same  computer.  They  are  always  system 
dependent . 


2-2 


PS  620142300 
1  November  1985 

SECTION  3 
REQUIREMENTS 


Structural  Descriptions 


The  NTM  Services  Modules  are  the  routines  that  are  bound 
with  IISS  APs  to  provide  the  management  of  the  AP's 
communication  with  the  IISS. 


3.2  Functional  Flow  Description 

The  logic  and  functional  flow  for  the  services  is  described 
in  the  Development  Specification  (DS  620142000).  The  NTM 
Services  can  be  grouped  according  to  their  basic  function  in  the 
following  way: 

The  NTM  Communication  Initiation  Routines: 

-  INICOM  (used  by  the  COMM  APs  for  initiation) 

-  INITAL  (used  for  initiation  by  all  IISS  APs  except 

COMM  and  the  UI) 

-  INITEX  (used  by  the  UI  AP  for  initiation) 

-  LOGON  (used  by  the  UI  to  send  user  logon 

information  to  the  NTM) 

The  NTM  Communication  Routines: 

-  CHGROL  (used  by  the  UI  to  tell  the  NTM  about  a 

user's  role  change) 

-  CHKMSG  (used  as  a  check  to  determine  whether  a 

message  has  arrived  for  the  AP) 

-  GDACK  (used  to  acknowledge  guaranteed  delivery 

messages) 

-  GDSEN  (used  to  send  guaranteed  delivery  messages) 

-  I SEND  (used  to  send  a  message  that  will 

specifically  cause  the  initiation  of  a  new 
instance  of  an  IISS  AP) 

-  NSEND  (used  to  send  message  to  other  IISS  APs) 

-  QSEND  (used  by  Queue-Server  APs  to  send  messages 

back  to  the  AP  whose  message  was  just 
received) 

(used  to  receive  any  messages  that  may  have 
been  sent  by  other  IISS  APs) 


RCV 
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-  SXGERR  (used  to  send  an  error  Message  to  both  the 

user  of  this  AP  and  the  MTM  Monitor) 

-  TSTHOD  (used  by  the  01  to  signal  Message  filtering 

needs) 


MTM  Status  Servioes 

-  GETUSR  (used  to  get  user  inforaatlon,  original 

souroe,  and  original  logical  channel) 

-  VHTHST  (used  to  deternine  host  naae  where  requested 

AP  resides) 


MTM  Teraination  Services 

-  LOGOFF  (used  by  the  01  to  inf ora  the  MTM  of  a  user 

logoff) 

-  TRMMAT  (used  by  all  ZISS  APs  to  terainate  their 

coaaunication  connection  to  the  MTM) 

-  TRMMAX  (used  by  the  OOMM  APs  to  terainate  their 

ooaaunioation  connection  to  the  MTM) 


3.3  Interfaces 


The  Network  Transaction  Manager  Maintains  coaeuni cat ions 
with  any  other  process  through  Mailboxes.  The  Mailboxes  are 
Managed  by  the  Interprocess  Coaaunication  Priaitives  (IPC's). 

Coaeuni cat ions  with  the  reaote  coaputer  is  accoaplished 
through  the  Coaaunication  sub-systea  prooess  which  will  be 
running  when  there  are  other  hosts  to  coaaunicate  with. 

3.4  Prograa  Interrupts 

Many  MTM  Services  are  interrupt  driven  with  interrupts 
coning  either  froa  the  IPC's  on  behalf  of  an  MTM  MPD .  Waiting 
for  these  interrupts  is  perforaed  by  one  of  the  I PC  wait 
priaitives.  If  a  response  aust  be  received  within  a  particular 
tiae  interval,  the  IPC's  associated  with  tiaing  are  used  along 
with  one  of  the  wait's. 

3.5  Tiaing  and  Sequence  Description 

The  MTM  does  not  depend  on  any  particular  tiaing  sequences. 

3.6  Special  Control  Features 


I 
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The  Network  Transaction  Manager  Subsystem  does  not  include 
any  speoial  control  features  as  defined  in  the  I CAM 
Documentation  Standards  manual . 

3.7  Storage  Allocation 

3.7.1  Data  Base  Definition 

3. 7. 1.1  File  Description 

All  file  handling  is  done  by  the  Message  Processing  Units 
and  not  by  the  NTH  Services  themselves. 

3. 7. 1.2  Table  Description 

The  tables  that  are  used  by  multiple  services  are  described 
in  the  Include  files  (Section  3.10.9).  The  local  data  is  also 
described  in  the  System  Programmer's  Manual  ( SUM6201 42000 ) . 

3. 7. 1.3  Item  and  Constant  Description 
Described  in  the  DS. 

3.7.2  CPC  Relationship 

3.8  Object  Code  Creation 

The  generic  portion  of  NTM  is  written  in  COBOL  and  'C' . 

This  has  been  successfully  compiled  on  a  VAX  11/780  under  VMS 
(Rel  2.0),  an  IBM  3084  under  MVS  (Rel  1.8),  and  a  Honeywell 
Level  6  under  Mod  400  (Rel  1.2). 

The  minimum  computer  hardware  and  software  required  to 
create  and  run  NTM  in  the  IISS  environment  is  documented  in  the 
Installation  Guide  for  IISS  on  the  VAX  and  in  the  Installation 
Guide  for  IISS  on  the  IBM. 

3.9  Adaption  Data 

The  command  procedures  to  create  the  IISS  AP  executables 
such  that  they  contain  the  NTM  Servioes  are  specific  to  each 
computer  and  can  be  found  under  Software  Configuration 
Management . 
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3.10  Detail  Design  Description 

The  upooming  program  details  were  derived  from  all  modules 
that  were  selected  when  the  following  Documentation  Group(s)  was 
ohosen : 

NTMSERV 


3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs"  which  are 
modules  that  are  not  called  by  any  other  module  being  documented 
here.  These  modules  are  either  program  entry  points  or,  if  they 
are  hooked  into  another  set  of  programs  via  subroutine  calls, 
they  are  the  points  the  external  programs  can  call  and  therefore 
enter  through.  To  differentiate  between  the  two  types  of  entry 
points,  look  at  the  individual  Module  Documentation  (section 
3.10.8)  and  look  at  Module  Type  for  each  of  the  Main  Program 
modules  listed.  Note  whether  the  routine  is  a  Program, 
Subroutine,  or  Function.  If  it  is  a  Program,  it  is  truly  a  main 
program  entry  point.  If  not,  then  it  is  merely  called  by  other 
programs  not  being  documented  here. 


Module  Mane 

ASCTIM 

CHGR0L2 

CHKMSG2 

ERRAPI 

FILGEM 

GDACK2 

GDSEND2 

GETTIM 

GETUSR2 

INICOM2 

IMITAL2 

IHITEX2 

INITIL2 

INSTNC2 

ISEHD2 

L0G0FF2 
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NTM/SERV  Main  Program  List 
Purpose 


CALLED  BY  MPU'S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 

CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 


TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS. 

WRITES  ERROR  RECORD  TO  ERROR-LOG  FILE 
ERRAPI .DAT. 

INTERFACE  TO  THE  FILE  NAME  QUEUE  SERVER. 

SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GET  THE  SYSTEM  TIME  AS  A  BINARY  STRING. 

RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INITIALIZE  APS  CONNECTION  TO  THE  IISS. 

INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 

INITIALIZE  UI  LIKE  AP’S  CONNECTION  TO  THE 
UIV  MPU. 

INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

GET  THE  SYSGEN  INSTANCE  NUMBER. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 


L0Q0N2 


SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 
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XTM/SERV  Main  Prograa  List 
Module  Xaae  Purpose 

MBXLG2  WRITES  MAILBOX  DATA  TO  ERRLOO-FILE  MBXLG2 . 

MBXLOG  WRITES  MAILBOX  DATA  TO  ERRLOO-FILE  MBXLOG . 

Q8EXD2  SERD  MESSAGES  TO  OTHER  APS  IX  THE  IISS 

FROM  Q SERVER  AP'S. 

RCLE  REMOTE  COMPILE  AXD  LIXK  EXPERT  DRIVER 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR  CALL  SIGERR2 

SXDRCLE  REMOTE  COMPILE  AXD  LIXK  EXPERT  CALLING 

SERVICE 

TRKMAX  CALL  TRMNAX2 

TSTMOD  CALL  COBOL  ROUTINE  TSTM0D2 


WHTHST 


CALL  WHTKST2 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  nodules  being  documented 
here  along  with  their  purpose.  Each  nodule  has  a  unique  name, 
no  natter  what  language  it  was  written  in. 
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Module  Vase 

ASCTIM 

CHGROL2 

CHKMSG2 

ERRAPI 

FILGEN 

GDACK2 

GDSEND2 

GETTIM 

GETUSR2 

IMIC0M2 

INITAL2 

INITEX2 

INITIL2 

INSTNC2 

ISEND2 

L0G0FF2 


RTM/SERV  Module  List 
Purpose 


CALLED  BY  MPO'S  TO  GET  THE  SYSTEM  TIME  AS 
AM  ASCII  STRING. 

CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

WRITES  ERROR  RECORD  TO  ERRLOG  FILE 
ERRAPI .DAT. 

INTERFACE  TO  THE  FILE  NAME  QUEUE  SERVER. 

SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GET  THE  SYSTEM  TIME  AS  A  BINARY  STRING. 

RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INITIALIZE  APS  CONNECTION  TO  THE  IISS. 

INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 

INITIALIZE  UI  LIKE  AP '  S  CONNECTION  TO  THE 
UIV  MPU. 

INITIALIZE  AN  AP '  s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

GET  THE  SYSGEN  INSTANCE  NUMBER. 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP . 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP . 


LOGON 2 


SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP . 
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Module  Marne 

MBXLG2 

MBXLOG 

MSEMD2 

POSTCOM 

PRECOM 

QSEND2 

ROLE 

RCLFILE 

RCV2 

SIGABT2 

SIGERR 

SIGERR2 

SMDRCLE 

TRMNAT 

TRMMAT2 

TRMMAX 

TRMNAX2 


MTM/SERV  Module  List 
Purpose 

WRITES  MAILBOX  DATA  TO  ERRLOG  FILE  MBXLG2 . 

WRITES  MAILBOX  DATA  TO  ERRLOG  FILE  MBXLOG. 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

WRITE  * CLEAN-UP“  CONTROL  CARDS  TO  THE  COMMAND 
FILE. 

WRITE  “SET-UP"  CONTROL  CARDS  TO  THE 
COMMAND  FILE. 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER. 

DO  COMMAND  FILE  OPERATIONS  FOR  RCLE. 

RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 
IISS  . 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
CALL  SIGERR2 

SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 
SERVICE 

CALL  TRMNAT2 

TERMINATE  AN  APS  CONNECTION  TO  THE  IISS. 

CALL  TRMNAX2 

TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


TSTMOD 


CALL  COBOL  ROUTINE  TSTM0D2 
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Module  N&ue 


TSTMOD2 


MTM/SERV  Module  List 
Purpose 


WHTHST 


VHTHST2 


SET/RESET  THE  TEST-MODE-FLAG. 

CALL  WHTHST2 

RETURNS  THE  NAME  OF  THE  HOST  OH  WHICH  AH 
AP  RESIDES. 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number  CM 
620100001).  See  section  3.10.6  for  a  list  of  the  modules  that 
call  each  of  these  external  routines. 
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NTM/SERV  External  Routines  List 


Module  Name 

First  User 

APACCT 

NHTHST 

CNLTIM 

1 SENDS 

CRTMBX 

IN I COM2 

DELMBX 

TRMNAT2 

ENDRUN 

TRMNAX2 

ERRPRO 

SIGERR2 

GETMSG 

RCV2 

GETNAM 

INITEX2 

INITAL 

ROLE 

I  SEND 

SNDRCLE 

LOCKEF 

INITAL2 

NSEND 

FILGEN 

RCV 

RCLE 

RCVMSG 

RCV  2 

RELEVB 

1NZTIL2 

SETTIM 

INITEX2 

SNDMSG 

TRMNAT2 

SYSSASCTIM 

ASCTIM 

SYSJCREPRC 

RCLE 

SYSJGETJPI 

RCLE 

SYSSGETTIM 

GETTIM 

WAIT01 

INITIL2 

WAIT02 

QSEND2 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in  by 
nodules  being  documented  here.  Each  include  file  has  a  unique 
name  regardless  of  the  language  being  used.  The  purpose  of  each 
include  file  is  listed  as  well.  A  nore  coaplete  description  of 
each  include  file  is  given  in  seotion  3.10.9.  The  purpose  listed 
is  the  one  that  is  in  the  souroe  oode  of  the  include  file. 

A  purpose  of  "**•*  PURPOSE  ROT  FOUHD  BT  STRIPPER  ••••■ 
indicates  that  a  purpose  stateaent  was  not  written  into  the 
include  file  itself.  The  aost  ooaaon  reason  for  this  is  that 
the  include  file  coaes  froa  systea  libraries  that  were  not 
developed  by  the  project,  such  as  'C'  libraries  that  are 
provided  with  the  'C'  coapiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all  the 
aodules  which  call  in  each  of  these  include  files. 
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Pile  Name 


» 

ADMSGH 
ALMSGH 
APCNM1 
APCNM2 
APIEVB 
API INI 
APILCL 
APINME 
BUFAPI 
COMAPC 
ERRPRO 
*  INICMD 

[  MSGSTR 

RETSTR 
SRVCD2 
SRVCDS 
SRVRET 
|  TSTMDE 


i 


i 


NTM/SERV  Include  File  List 

Purpose 


THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR - RETURNS . 
INITIALIZE  LOCAL  NTM- MESSAGE  VARIABLES. 

APC  GLOBAL  NAME  DATA. 

A PC  GLOBAL  NAME  DATA. 

NTM  EVENT  BLOCKS. 

FOR  INITIATION  PURPOSES 
THE  APIS  COMMON  LOCAL  DATA. 

API  GLOBAL  NAME  DATA. 

API  GLOBAL  BUFFER  DATA. 

HARD  CODED  APC  NAMES  FOR  COMM. 

PROCESS  ERROR  INCLUDE  FILE. 

INITIALIZATION  MESSAGE  FORMAT. 

MESSAGE  FORMAT  INCLUDE  FILE. 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR - RETURN S . 
SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
NTM  SERVICE  STATUS  CODES. 

TEST  MODE  FLAG. 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and  all 
the  modules  documented  in  this  specification  which  include  them. 
The  purpose  of  each  module  is  listed  as  well. 
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NTM/SERV  Where- i nc 1 ude-f i le-used  List 

Include  Module  Module 

File  N&ae  Purpose 


ADMSGH 

TRMMAT2  TERMINATE  AN  APS  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM'S  CONNECTION  TO  THE  IISS. 


ALMSGH 

INICOM2  INITIALIZE  APS  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP '  S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP  ’  S  CONNECTION  TO  THE 
OIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 


APCNM1 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 


APCNM2 

INITAL2  INITIALIZE  AP ' S  CONNECTION  TO  THE  T1V  MPU. 
INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 


APIEVB 

CHGR0L2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 
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MTM/SERV  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INITAL2  INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP . 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON 2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  A P'S. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR  CALL  SIGERR2 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TRMNAT  CALL  TRMNAT2 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

TSTMOD  CALL  COBOL  ROUTINE  TSTM0D2 

WHTHST  CALL  WHTHST2 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 

AP  RESIDES. 


API INI 

INITAL2  INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 
INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 
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NTM/SERV  Where- inc 1 ude-f i le-used  List 

Include  Module  Module 

File  Marne  Purpose 


APILCL 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INITAL2  INITIALIZE  AP '  S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 

UIV  MPU. 

INITIL2  INITIALIZE  AH  AP's  CONNECTION  TO  AN  AP 

*  SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

TRMNAT2  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


APINME 

CHGR0L2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 
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NTM/SERV  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


GETUSR2  RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP '  S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

L0G0FF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON 2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR  CALL  SIGERR2 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TRMNAT  CALL  TRMNAT2 

TRMNAT2  TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 

WHTHST  CALL  WHTHST2 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 

AP  RESIDES. 


BUFAPI 

CHGR0L2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GETUSR2  RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 
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MTH/SERV  Where- i nc 1 ude-f i le-used  List 


Include 

Module 

Module 

File 

Mane 

Purpose 

INITEX2 

INITIALIZE  01  LIKE  APS  CONNECTION  TO  THE 
UIV  MPO. 

INITIL2 

INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPO. 

ISEND2 

SEND  MESSAGE  THAT  WILL  CAOSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

L0Q0FF2 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON 2 

SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCV2 

RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 
IISS  . 

SIGABT2 

SIGNAL  THE  MPO  TO  ABORT  A  CHILD  AP 

SIGERR 

CALL  SIGERR2 

SIGERR2 

SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOORCE. 

WHTHST 

CALL  WHTHST2 

WHTHST2 

RETORN S  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 

COMA PC 

TRMNAX2 

TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 

ERRPRO 

CHGR0L2 

CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS. 

FILGEN 

INTERFACE  TO  FILE  NAME  QUEUE  SERVER. 

GDACK2 

SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU . 

GDSEND2 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 
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NTM/SERV  Where- include-f lie-used  List 

Include  Module  Module 

File  Name  Purpose 


GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INIGOM2  INITIALIZE  APS  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

L0G0FF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

LOGON2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCLE  REMOTE  COMPILE  AMD  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TRMNAT2  TERMINATE  AN  APS  CONNECTION  TO  THE  IISS. 

TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


INICMD 

INIC0M2  INITIALIZE  AP ' S  CONNECTION  TO  THE  IISS. 


MSGSTR 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 


PS  620142S00 
1  November  1965 


NTM/SERV  Where- 1 nc 1 ude-f i le-used  List 

Include  Module  Module 

File  Mane  Purpose 


ISEMD2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE 

IISS  . 


RETSTR 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GETUSR2  RETURNS  ORIGINAL  SOURCE,  LOGICAL  CHANNEL, 
AND  USER  NAME. 

INITAL2  INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP . 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP . 

LOGON 2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP . 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

TRMNAT2  TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 


PS  620142300 
1  November  1985 


NTM/SERV  Where- include-f ile-used  List 

Include  Module  Module 

File  Marne  Purpose 


TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 
WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


SRVCD2 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GETUSR2  RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL. 
AND  USER  NAME. 

L0G0FF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
LOGON 2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

TSTM0D2  SET/RESET  THE  TEST-MODE-FLAG. 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


SRVCDS 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INITAL2  INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  /N  AP ' S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 


PS  620142300 
1  November  1985 


MTM/SERV  Where- include-f i le-used  List 

Include  Module  Module 

File  Mane  Purpose 


RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IM  THE 

IISS  . 

TRMHAT2  TERMINATE  AN  APS  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM ‘ S  CONNECTION  TO  THE  IISS. 


SRVRET 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

FILGEN  INTERFACE  TO  FILE  NAME  QUEUE  SERVER. 
GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GETUSR2  RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL, 
AND  USER  NAME. 

LOGOFF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 
LOGON 2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP . 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

SNDRCLE  REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 
SERVICE 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


TSTMDE 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GETUSR2  RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 
INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP . 


LOGON 2 


PS  620142300 
1  November  1985 


NTM/SERV 

Include 

File 


Where- include-f i le-used  List 

Module  Module 

Name  Purpose 


RCV2 

SIGABT2 

TSTM0D2 

WHTHST2 


RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 
IISS  . 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
SET/RESET  THE  TEST-MODE-FLAG. 

RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 


PS  620142300 
1  November  1985 


3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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NTM/SERV  Vhere-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


APACCT 

SIGERR  CALL  SIGERR2 

TRMNAT  CALL  TRMNAT2 

TRMNAX  CALL  TRMNAX2 

TSTMOD  CALL  COBOL  ROUTINE  TSTM0D2 

WHTHST  CALL  WHTHST2 


CNLTIM 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 


CRTMBX 

INICOM2  INITIALIZE  AP ' S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP ' S  CONNECTION  TO  THE  T1V  MPU . 

INITEX2  INITIALIZE  UI  LIKE  AP ' S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 


DELMBX 

INITAL2  INITIALIZE  AP '  S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 

UIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

TRMNAT2  TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 


PS  620142300 
1  November  1985 


NTM/SERV  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


ENDRUN 

TRMHAT2  TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


ERRPRO 

CHGROL2  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED 
ON. 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

FILGEN  INTERFACE  TO  THE  FILE  NAME  QUEUE  SERVER. 

GDACK2  SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

GETUSR2  RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL. 
AND  USER  NAME. 

INICOM2  INITIALIZE  AP '  S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP ' S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP . 

L0G0FF2  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP . 

LOGON 2  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP . 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP ' S . 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP ' S  IN  THE 

IISS  . 

SIGABT2  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

SIGERR2  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

TRMNAT2  TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 

TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 

WHTHST2  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 
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NTM/SERV  Where-external-rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


GETMSG 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INICOM2  INITIALIZE  APS  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  APS  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP ' S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 


GETNAM 

INIC0M2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP's  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

MBXLOG  PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 

TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


INITAL 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
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NTM/SERV  Where-extern&l -routine-used  List 

Systea  Module  Module 

Module  R&ae  Purpose 


I  SEND 

SNDRCLE  REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 
SERVICE 


LOCKEF 

INITAL2  INITIALIZE  AP ' S  CONNECTION  TO  THE  T1V  MPO . 


NSEND 

FILGEN  INTERFACE  TO  THE  FILE  NAME  QUEUE  SERVER 
RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


RCV 

FILGEN  INTERFACE  TO  THE  FILE  NAME  QUEUE  SERVER 
RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


RCVMSG 

CHKMSG2  TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INIC0M2  INITIALIZE  AP  S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP  S  CONNECTION  TO  THE  T1V  MPU . 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' s  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 
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PS  620142300 
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NTM/SERV  Where -external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IN  THE 

IISS  . 


RELEVB 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 
INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

TRMNAT2  TERMINATE  AN  APS  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


SETTIM 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INIC0M2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

IMITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

IMITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEMD2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEMD2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

TRMNAT2  TERMINATE  AN  APS  CONNECTION  TO  THE  IISS. 
TRMMAX2  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 
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PS  620142300 
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NTM/SERV  Where-external -routine-used  List 

Systen  Module  Module 

Module  Mane  Purpose 


SNDMSG 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INICOM2  INITIALIZE  AP '  S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  APS  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP ' S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

TRMNAT2  TERMINATE  AN  APS  CONNECTION  TO  THE  IISS. 
TRMNAX2  TERMINATE  COMM'S  CONNECTION  TO  THE  IISS. 


SYS$ASCTIM 

ASCTIM  CALLED  BY  MPU ' S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 


SYSSCREPRC 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


SYSSGETJPI 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


SYSSGETTIM 


PS  620142300 
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NTM/SERV  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


ASCTIM  CALLED  BY  MPU'S  TO  GET  THE  SYSTEM  TIME  AS 
AN  ASCII  STRING. 

GETTIM  GET  THE  SYSTEM  TIME  AS  A  BINARY  STRING. 


WAIT01 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INICOM2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

NSEND2  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCLE  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 

IISS  . 

TRMNAT2  TERMINATE  AN  AP ' S  CONNECTION  TO  THE  IISS. 

TRMNAX2  TERMINATE  COMM  S  CONNECTION  TO  THE  IISS. 


WAIT02 

GDSEND2  SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

INIC0M2  INITIALIZE  AP'S  CONNECTION  TO  THE  IISS. 

INITAL2  INITIALIZE  AP'S  CONNECTION  TO  THE  T1V  MPU. 

INITEX2  INITIALIZE  UI  LIKE  AP'S  CONNECTION  TO  THE 
UIV  MPU. 

INITIL2  INITIALIZE  AN  AP'S  CONNECTION  TO  AN  AP 
SELECTED  MPU. 

ISEND2  SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 
INITIATION  OF  AN  AP. 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 


NSEND2 


PS  620142300 
1  lfoveaber  1985 


NTM/SERV  Where -external -routine-used  List 

Systen  Module  Module 

Module  Mane  Purpose 


QSEND2  SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  APS. 

RCV2  RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 

IISS  . 
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The  following  lists  each  Main  Program  listed  in  3.10.1  and 
all  the  modules  which  are  called  either  by  that  module  itself  or 
by  any  of  the  documented  modules  which  it  calls.  It  is  possible 
for  a  non-main  nodule  to  be  listed  more  that  once  if  it  is 
called  by  multiple  modules.  The  called  modules,  in  this  case 
known  as  program  parts,  are  marked  as  to  whether  they  are 
documented  here.  If  so.  the  phrase  "well-defined  module" 
appears  by  the  module  name,  if  not  it  is  an  "external  "routine". 
The  Purpose  of  the  Main  Program  module  is  listed  as  well. 


PS  620142300 
1  November  1985 


MTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

MaiHB  Marne  Type 


ASCTIM  Purpose—  >  CALLED  BT  MPO'S  TO  GET  THE 

SYSTEM  TIME  AS  AM  ASCII  STRING. 
SYS$ASCTIM  External  routine 

SYSSGETTIM  External  routine 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


CHGR0L2 


CNLTIM 

ERRPRO 

GETMSG 

NSEND2 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WA1T02 


Purpose— >  CHANGE  THE  ROLE  UNDER  WHICH  A 
USER  LOGGED  ON. 

External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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MTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Marne  Marne  Type 


CHKMSG2  Purpose—  >  TO  CHECK  FOR  MESSAGES  FROM  OTHER 

APS  IN  THE  IISS. 

ERRPRO  External  routine 

GETMSG  External  routine 

RCVMSG  External  routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

FILGEN 

ERRPRO 

NSEND 

RCV 

Purpose—  >  INTERFACE  TO  THE  FILE  NAME  QUEUE 
SERVER. 

External  routine 

External  routine 

External  routine 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


GDACK2 


CNLTIM 

ERRPRO 

GETMSG 

NSEND2 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 


Purpose— >  SENDS  GD  ACK  MESSAGE  TO  LOCAL 
MPO . 

External  routine 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
Externa  routine 
Externa!  routine 
External  routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

GDSEND2 

Purpose—  >  SEND  MESSAGES  THAT  REQUIRE 

GUARANTEED  DELIVERY  PROCESSING. 

CNLTIM 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAIT01 

External 

routine 

WAIT02 

External 

routine 
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MTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Marne  Marne  Type 


»* 

» 


GETTIM  Purpose—  >  GET  THE  SYSTEM  TIME  AS  A  BINARY 

STRING. 

SYS$GETTIM  External  routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgn 

Module 

Module 

Name 

Name 

Type 

GETUSR2 

Purpose —  > RETURNS  ORIGINAL  SOURCE,  LOGICAL 
CHANNEL,  AND  USER  NAME. 

CNLTIM 

External  routine 

ERRPRO 

External  routine 

GETMSG 

External  routine 

NSEND2 

Well-defined  module 

RCV2 

Well-defined  module 

RCVMSG 

External  routine 

RELEVB 

External  routine 

SETTIM 

External  routine 

SNDMSG 

External  routine 

WAIT01 

External  routine 

WAIT02 

External  routine 

3-43 
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HTM/SERV  Main  Program  Parts  List 


Main  Pgn  Module 
Mane  Mane 


Module 

Type 


INIG0M2 


CRTMBX 

ERRPRO 

GETMSG 

GETMAM 

RCVMSG 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 


Purpose— >  INITIALIZE  AP  S  00MMECTI0M  TO 
THE  IISS. 

External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 


3-44 
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MTM/SEHV  Main  Program  Parts  List 

Main  Pga  Module  Module 

Marne  Marne  Type 


IMITAL2 


CRTMBX 

DELMBX 

ERRPRO 

GETMSG 

GETMAM 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SMOMSG 

VAIT01 

VAIT02 


Purpose—  .IMITIALIZE  AP  S  CONNECTION  TO 
THE  T1V  MPU. 

External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 


3-45 


PS  620142300 
1  November  1985 


MTM/SERV  Main  Program  Parts  List 


Main  Pgn 

Module 

Module 

Marne 

Marne 

Type 

INITEX2 

Purpose— > INITIALIZE  UI  LIKE  AP 
CONNECTION  TO  THE  OIV 

CRTMBX 

External 

routine 

DELMBX 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

GETNAM 

External 

routine 

RCVMSG 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAIT01 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


INITIL2 


CRTMBX 

Purpose— > INITIALIZE  AN  AP's  CONNECTION  TO 
AN  AP  SELECTED  MPO. 

External  routine 

DELMBX 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

GETNAM 

External 

routine 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAIT01 

External 

routine 

WAIT02 

External 

routine 

3-47 
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MTM/SERV  Main  Program  Parts  List 


Main  Pgn  Module 
Marne  Name 


ISEMD2  Purpose- 

CNLTIM 

ERRPRO 

GETMSG 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 


Module 

Type 


>  SEND  MESSAGE  THAT  WILL  CAUSE  THE 
SPECIFIC  INITIATION  OF  AN  AP. 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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HTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

LOGOFF2 

Purpose—  >  SENDS  LOGOFF  MESSAGE  TO  THE 
MONITOR  AP. 

CNLTIM 

External  routine 

ERRPRO 

External  routine 

GETMSG 

External  routine 

NSEND2 

Well-defined  module 

RCVMSG 

External  routine 

RELEVB 

External  routine 

SETTIM 

External  routine 

SNDMSG 

External  routine 

WAIT01 

External  routine 

WAIT02 

External  routine 
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NTM/SERV  Main  Progran  Parts  List 

Main  Pgn  Module  Module 

Mane  Name  Type 


L0G0N2 


CNLTIM 

ERRPRO 

GETMSG 

NSEND2 

RCV2 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAIT01 

WAIT02 


Purpose— >  SENDS  LOGON  MESSAGE  TO  THE 
MONITOR  AP. 

External  routine 
External  routine 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

MBXLOG 

GETNAM 

Purpose—  > PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 
External  routine 
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MTM/SERV  Main  Program  Parts  List 

Main  Pgn  Module  Module 

Haae  Mane  Type 


CNLTIM 

Purpose— > SEND  MESSAGES  TO  OTHER  APS  IN 
THE  IISS  FROM  QSERVER  AP'S. 
External  routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAIT01 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 
Name 


RCLE 


Module 

Module 

Name 

Type 

Purpose — 

> REMOTE  COMPILE  AND  : 

DRIVER 

APACCT 

External 

routine 

DELMBX 

External 

routine 

ENDRON 

External 

routine 

ERRPRO 

External 

routine 

INITAL 

External 

routine 

NSEND 

External 

routine 

POSTCOM 

Well-defined  module 

PRECOM 

Well-defined  module 

RCLFILE 

Well-defined  module 

RCV 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

SYSSCREPRC 

External 

routine 

SYSSGETJPI 

External 

routine 

TRMNAT 

Well-defined  module 

TRMNAT2 

Well-defined  module 

WAIT01 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 

Main  Pgn  Module  Module 

Marne  Name  Type 


SIGABT2 


Purpose—  >  SIGNAL  THE  MPU  TO  ABORT  A  CHILD 


AP 

CNLTIM 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

NSEND2 

Well-defined  module 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

WAIT01 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

SIGERR  Purpose-- » CALL  S1GERR2 


APACCT 

External 

routine 

CNLTIM 

External 

routine 

ERRPRO 

External 

routine 

GETMSG 

External 

routine 

NSEND2 

Well-defined  module 

RCVMSG 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SIGERR2 

Well-defined  module 

SNDMSG 

External 

routine 

WAIT01 

External 

routine 

WAIT02 

External 

routine 
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NTM/SERV  Main  Program  Parts  Li6t 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

TRMNAX  Purpose— > CALL  TRKMAX2 


APACCT 

External 

routine 

ENDRUN 

External 

routine 

ERRPRO 

External 

routine 

GETNAM 

External 

routine 

RELEVB 

External 

routine 

SETTIM 

External 

routine 

SNDMSG 

External 

routine 

TRMNAX2 

Well-defined  module 

WAIT01 

External 

routine 

PI  080142800 
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ITM/IHV  Halt  Profraa  Farts  List 


Mala  Pfa 


Pwrposa —  »GALL  0080L  MOOTIMC  TtTMOOB 


APAOCT 
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nw/SEXV  Main  Prof ran  Parts  List 


Mala  Pfa  Module 


Module 

Type 


VRTKiT 

APAOCT 

CMLTIM 

EftftPftO 

GETH8C 

MSEVD2 

RCV2 

BCVMSG 

KELEVB 

SETT IK 

SVDMSG 

WAIT01 

WAIT02 

VMTMST2 


external  routine 
External  routine 
External  routine 
External  routine 
Well-defined  nodule 
Well-defined  nodule 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  nodule 


Purpose--* CALL  WHTH8T2 
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3.10.6  Modal e  Documentation 

The  following  documentation  describes  information  which  is 
specific  to  each  individual  module  being  documented  in  this 
specification  as  listed  in  section  3.10.2.  It  provides  a 
compact  way  of  getting  information  that  would  be  otherwise 
buried  within  each  module's  souroe  oode. 

The  specific  items  in  this  module  documentation  have  the 
following  meanings: 

NAME:  Marne  of  program  Module. 

PURPOSE:  Purpose  of  Module  as  detailed  in  the 

souroe  code. 

LANGUAGE:  Programming  language  souroe  code  is 

written  in. 

The  ohoioes  are: 

VAX- 11  FORTRAN 

C  (I/S-l  Workbench  C) 

VAX- 11  COBOL 

MODULE  TYPE:  Whether  a  Program.  Subroutine,  or 

Function . 

SOURCE  FILE:  Name  of  Source  File  from  file 

specification . 

SOURCE  FILE  TYPE:  Source  File  Extension  from  file 

specification . 

HOST:  Whether  this  is  a  host -dependent 

routine  (VAX  or  IBM)  or  blank  if 
host -independent . 

SUBSYSTEM:  IISS  sub-system  this  file  resides  in. 

SUBDIRECTORY:  Sub-directory  of  that  subsystem  in 

which  this  file  resides. 

DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


DESCRIPTION: 


A  description  of  the  module  as  otained 
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f 


from  the  souroe  code. 

ARGUMENTS:  The  arguments  with  whioh  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 

INCLUDE  FILES:  A  list  of  all  the  files  that  are 

included  into  this  nodule  as  well  as 
their  purposes. 

ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by 
this  nodule,  if  any. 

CALLED  DIRECTLY  BY:  The  documented  routines  whioh  oall 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM(S) :  The  documented  Main  Programs  which 

oontain  this  module  in  their  parts 
list  aooording  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  aooording 
to  Module  Name. 
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MTM/8XRV  Module  Documentation 


SAMI:  A8CTIH 

PURPOSE:  CALLED  BT  NPU'S  TO  OET  TBS  SYSTEM  TIME  AS 

AM  ASCII  STRING. 

LANGUAGE :  VAX-11  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  PILE:  A8CTIM 

SOURCE  PILE  TYPE:  COB 

MOST:  VAX 

SUBSYSTEM :  NTH 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTM8ERV 

DESCRIPTION: 


-  CALLS  VMS  8ERVICX8 :  8Y8SGETTIM 


SYSSASCTIM 


ARGUMENTS: 


TIME-STRING  -  D8PLY  [X(23)l 
NTH -RETURN  -  DSPLY  [1(5)3 
88-STATUS  -  DSPLY  [80(0)1 


ROUTINES  CALLED: 


SY8SGETTIM 

SYSSASCTIM 
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NTH/SERV  Module  Documentation 


HAMS: 

PURPOSE : 

LANGUAGE: 

MODULI  TTPI: 

SOUMCE  FILE: 
sound  FILE  TYPE: 
MOST: 

SUBSYSTEM : 

SUBDIKECTOBY : 
DOCUMENT AT I ON  GNOUP : 

DESCRIPTION 


CM0K0L2 

CHANGE  THE  ROLE  UNDER 
ON. 

VAX- 11  COBOL 
SUBROUTINE 
CHGR0L2 
OOB 

NTH 

SERVICES 

NTMSERV 


WHICH  A  USER  LOGGED 


ARGUMENTS 


TERMINAL-ID  -  D8PLY  (X(3)J 
USER-NAME  -  DSPLY  [X(8)] 

ROLE-NAME  -  DSPLY  [X(10)l 
RTN-OODE  -  DSPLY  tX(B)J 
API -GLOBAL-NAME -SEC  -  RECRD 
API -GLOBAL-BUFFER- SEC  -  RECRD 
NOT -MBX- EVENT -BLK  -  DSPLY  (X(2032)) 
OOLD-MBX -EVENT -BLK  -  D6PLT  (X(2032)) 
SEND- EVENT -BLE  -  DSPLY  [X(2032)J 
Ad-NBX-FVENT-BLX  -  DSPLY  (X(2032)) 
TIMER -EVENT -BLE  -  DSPLY  lX(80)J 


INCLUDE  FILES: 


SRVRET  -  NTH  SERVICES  STATUS  CODES 

RETSTR  -  THE  APIS  OOMNON  LOCAL  DATA  FOR  ERROR- RETURNS 

SRVCD2  -  SERVId  CODES  FOR  THE  NTH  SERVId  ROUTINES 

APXHHE  -  API  GLOBAL  NAME  DATA 

BUFAPI  -  API  GLOBAL  BUFFER  DATA 

APIEVB  -  NTH  EVENT  BLOCKS 


3-83 


iviiRvrmvvinin  wwrumiwvwiB 
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SMPftO  -  PftOCSSS  KUOS  XVCLODC  FILE. 


aOOTXnS  CALZJED: 


MUDS  -  SUD  MSS  SAGS  TO  AM  AP  XV  TMS  XXSS. 


3-64 


.V.V.V. 
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NTM/SERV  Module  Documentation 


NAME: 
PURPOSE : 


LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


CHKMSG2 

TO  CHECK  FOR  MESSAGES  FROM  OTHER  APS  IN 
THE  IISS  . 

VAX- 11  COBOL 
SUBROUTINE 
CHKMSG2 
.COB 


SUBSYSTEM :  NTH 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ARGUMENTS: 


LOGICAL-CHANNEL  -  INS  PLY  [X(  3)  ] 

MSG- SOURCE  -  DSPLY  [X(10)l 

ACCEPT - STATUS  -  DSPLY  [X(5)J 

API -GLOBAL-NAME-SEC  -  RECRD 

API -GLOBAL-BUFFER-SEC  -  RECRD 

MOT -MBX- EVENT -BLX  -  DSPLY  [X(2032)) 

COLD- MBX- EVENT -BLX  -  DSPLY  [X(2032>] 

SEND- EVENT -BLX  -  DSPLY  (X(2032)] 

ACX -MBX -EVENT -BLX  -  DSPLY  [X(2032)) 
TIMER -EVENT -BLX  -  DSPLY  [X(80) } 
TEST-MODE-FLAG  -  D6PLY  [X] 


INCLUDE  FILES: 


MSG8TR 

APILCL 

SRVCDS 

RET8TR 

APINME 

BUFAPI 


MESSAGE  FORMAT  INCLUDE  FILE. 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR -RETURNS . 
API  GLOBAL  NAME  DATA. 

API  GLOBAL  BUFFER  DATA. 
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APIEVB  -  NTH  EVENT  BLOCKS. 

TSTMDE  -  TEST  MODE  FLAG. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


RCVMSG 

GETMSG 

ERRPRO 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE 
HOST : 

SUBSYSTEM : 
SUBDIRECTORY : 


ERRAPI 

WRITES  ERROR  RECORD  TO  ERRLOG  FILE 

ERRAPI .DAT 

VAX- 11  COBOL 

SUBROUTINE 

ERRAPI 

.COB 

VAX 

NTM 

SERVICES 


DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


CALL-NAME  -  DSPLY  [X(6)] 
ROUTINE-NAME  -  DSPLY  [X(8)] 
RET -CODE  -  DSPLY  [X'5)] 
SS-STATUS  -  DSPLY  [S9(9)J 
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VTM/SERV  Module  Documentation 


MAMS: 

PURPOSE : 

LAMGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
met  * 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


FILGEB 

INTERFACE  TO  THE  FILE  NAME  QUEUE  SERVER 

VAX-11  COBOL 

SUBROUTINE 

FILGEB 

.OOB 


NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


THE  PURPOSE  OF  THIS  ROUTINE  IS  TO  ACT  AS  A 
GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER. 

aod  for  release  2.0  to  return  a  ret-status 
WILL  ASK  FOR  AND  RECEIVE  A  BLOCK  OF  20  NAMES 
AND  HAND  THEM  OUT  TO  A  CALLER  1  AT  A  TIME. 

IF  I NUT -HOST  NAME  IS  BLANK.  THEN  USE  THE 
CURRENT  HOST  AND  PASS  IT  BACK  TO  THE  CALLER. 

COPY  OF  GENFIL  RENAMED  AS  FILGEB  FOR  USE  IN  NTM. 


ARGUMENTS : 


FILE-HOST  -  DSPLY  [XXX] 


INCLUDE  FILES: 


SRVRET  -  NTM  SERVICES  STATUS  OODCS 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED 


NS  END 
RCV 

ERRPRO 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE 
SOURCE  FILE  TYPE 


GDACK2 

SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPD 

VAX- 11  COBOL 

SUBROUTINE 

GDACK? 

COB 


HOST: 

SUBSYSTEM :  NTH 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP  MTMSERV 


DESCRIPTION : 


SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU  THIS  INFORMS 
THE  MPU  THAT  THE  AP  HAS  ACCEPTED  THE  TD  MESSAGE 


ARGUMENTS 


MESSAGE -SERIAL -NUMBER  -  DSPLY  (X(7)] 
RETCODE  -  DSPLY  [X(5>] 

API -GLOBAL -NAME -SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  «  RECRD 
MOT -MBX- EVENT -BLK  -  DSPLY  [X(2032>] 
COLD-MBX- EVENT -BLX  •  DSPLY  [X(2032)] 
SEND- EVENT -BLK  -  DSPLY  [X(2032)] 

ACK -MBX- EVENT -BLX  -  DSPLY  1X12032)] 
TIMER -EVENT -BLK  -  DSPLY  [X(80)] 


INCLUDE  FILES 


SRVRET 
SRVCD2 
RETSTR 
APILCL 
APINME 
BUFAPI 
APIEVB 
ERR PRO 


NTM  SERVICES  STATUS  CODES 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS 

THE  APIS  COMMOM  LOCAL  DATA 

API  GLOBAL  NAME  DATA 

API  BLOBAL  BUFFER  DATA 

NTM  EVENT  BLOCKS 

PROCESS  ERROR  INCLUDE  FILE 
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ROUTIEES  CALLED: 


MSEMD2  -  SEED  MESSAGE  TO  A*  AP  IM  THE  IISS. 

EREPMO 


3-70 


WfM' 


UUHIR 


SR! 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GDSEND2 

SEND  MESSAGES  THAT  REQUIRE  GUARANTEED 
DELIVERY  PROCESSING. 

VAX- 11  COBOL 
SUBROUTINE 
GDSEND2 
.COB 


SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


DSTINATION  -  DSPLY  [X(10)] 

LOG I CAL -CHANNEL  -  DSPLY  [ X( 3 ) ] 
TIMEOUT-VALUE  =  DSPLY  [X(15)3 
DATA-TYPE  -  DSPLY  [X] 

MESSAGE-TYPE  -  DSPLY  [X(2)3 
SEND-SIZE  -  DSPLY  [9(5)3 
USER -DATA  -  RECRD 
ACCEPT -STATUS  -  DSPLY  [X(5)3 
MESSAGE -SERIAL-NUMBER  -  DSPLY  [X(7)3 
API -GLOBAL -NAME -SEC  -  RECRD 
API  GLOBAL-BUFFER-SEC  -  RECRD 
NOT  NBX- EVENT -BLK  -  DSPLY  [X(2032)3 
OOLD  MB* -EVENT -BLK  -  DSPLY  [X( 2032)1 
SIND  EVENT -BLK  -  DSPLY  [X(2032)3 
AOI  Ml*  EVr NT  BLK  -  DSPLY  [X(2032)J 
■MNEP  EVENT  BLK  -  DSPLY  (X(80)l 


mi  Ann  r’i.r.' 


mm  .* 


impost 
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APILCL  -  THE  APIS  COMMON  LOCAL  DATA. 

8RVCDS  -  SERVICE  CODES  POE  THE  ETM  SERVICE  ROOT I EES . 

RETSTR  -  THE  APIS  COMMON  LOCAL  DATA  POE  ERR0R~RET0RH8 . 

APIEME  -  API  GLOBAL  HAKE  DATA. 

BUFAPI  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  HTM  EVERT  BLOCKS. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SNDMSG 

SETTIM 

VAIT01 

RCVMSG 

VAIT02 

GETMSG 

CNLTIM 

RELEVB 

ERRPRO 
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MTM/SERV  Module  Docuaentat i on 


■AME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


GETTIM 

GET  THE  SYSTEM  TIME 

VAX- 11  COBOL 

SUBROUTINE 

GETTIM 

.COB 

VAX 

NTM 

SERVICES 

NTMSERV 


AS  A  BINARY  STRING. 


-  CALLS  VMS  SERVICES:  SYS$GETTIM 

THE  GET  TIME  SYSTEM  SERVICE  FURNISHES  THE  CURRENT  SYSTEM 
TIME  IN  64-BIT  FORMAT.  THE  SYSTEM  TIME  IS  UPDATED  EVERY 
10  MILLISECONDS,  AND  THE  TIME  IS  RETURNED  IN 
lOO-NANOSECOND  UNITS  FROM  THE  SYSTEM  BASE  TIME. 


ARGUMENTS : 


TIME-VALUE  -  DSPLY  [9(18)3 
NTM -RETURN  =  DSPLY  [X(5)3 
SS-STATUS  =  DSPLY  [S9(9)3 


ROUTINES  CALLED: 
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RTM/SERV  Module  Doouuiitat 1 on 


MAMS:  GETU8R2 

PURPOSE:  RSTURMS  ORIGINAL  SOURCE.  LOGICAL  CHARREL. 

AMD  USER  RAMS. 

LARGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  SUBROUT I RE 

SOURCE  FILE:  GETUSR2 

SOURCE  FILE  TYPE:  .COB 

MOST: 

SUBSYSTEM :  MTM 

SUBDIRECTORY :  SERVICES 

DOCUMENT AT I OH  GROUP:  RTMSERV 

DESCRIPTION: 


RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL.  AND 
USER  NAME  TO  THE  CALLING  AP.  ROTE:  USER  RAME 
IS  RETURNED  ONLY  IF  THE  ORIGINAL  SOURCE  AP 
IS  THE  USER  INTERFACE. 


ARGUMENTS : 


R-AP-NAME  -  DSPLY  [XC 10) ] 
LOGICAL-CHANNEL  -  DSPLY  [X(3)] 
USER-NAME  -  DSPLY  tX(8)3 
ROLE-NAME  -  DSPLY  [X(10)3 
TERM-ID  -  DSPLY  [X(2)3 
GETUSR-RET  -  DSPLY  [X(5)] 

API -GLOBAL-NAME-SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT -MBX-EVENT-BLK  -  DSPLY  [X(2032)3 
COLD- MBX- EVENT -BLK  -  DSPLY  [XC2032)] 
SEND-EVENT-BLK  -  DSPLY  [X(2032)] 

ACX -MBX -EVENT- BLK  -  DSPLY  [X(2032)3 
TIMER -EVENT -BLK  -  DSPLY  [X(80)3 
TEST-MODE-FLAG  -  DSPLY  [X] 


INCLUDE  FILES: 


PS  620142300 
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SRVRET 

SRVCD2 

RETSTR 

APINME 

BUFAPI 

APIEVB 

TSTMDE 

ERRPRO 


ROUTINES  CALLED: 


NSEND2  -  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

RCV2  -  RECEIVE  MESSAGES  FROM  OTHER  AP '  S  IN  THE  IISS  . 

ERRPRO 


-  NTM  SERVICES  STATUS  CODES.. 

-  SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 

-  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
-API  GLOBAL  NAME  DATA. 

-  API  GLOBAL  BUFFER  DATA. 

-  NTM  EVENT  BLOCKS. 

-  TEST  MODE  FLAG. 

-  PROCESS  ERROR  INCLUDE  FILE 


PS  630143900 
1  lovrater  1089 


NTM/8ERV  Module  Doouaon tat 1 on 


MANE :  IMZ00M3 

PURPOSE:  IRZTIALISE  APS  OOMMSCTIOM  TO  THE  IISS. 

LANGUAGE :  VAX- 1 1  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE :  XNX00M2 

SOURCE  FILE  TYPE:  .COB 

HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 

DESCRIPTION: 


ARGUMENTS : 


COMM -RCV - EVENT -BLOCK  .  DSPLY  tX(2032)] 
INPUT-MBX-NAME  -  DSPLY  [X(14)J 
APC-HOT-MBX-NAME  -  DSPLY  tX(14>] 
APC-COLD-MBX-NAME  -  DSPLY  [X(14)] 
RET-STATUS  -  DSPLY  [X(5)] 

MPU- INSTANCE  -  DSPLY  [XX] 


INCLUDE  FILES: 


ALMSGH  -  INITIALIZE  LOCAL  NTM-MESSAGE  VARIABLES. 

INICMD  -  INITIALIZATION  MESSAGE  FORMAT. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE. 


ROUTINES  CALLED: 


GETNAM 
CRTMBX 
SNDMSG 
SETT I M 
WAIT01 


3-76 
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RCVM8G 

VAIT02 

GETMSG 

nut  pro 


3-77 


Ft  680142900 
1  lovotbir  1065 


NTM/SBRV  Module  Doouaoatat Ion 


MANS: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
MOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMEXT AT I OR  GROUP: 


IRITAL2 

IBITIALIEE  APS  OOHRECTIOB  TO  THE  T1V  MPU. 

VAX- 11  COBOL 

SUBROUTIBE 

IHITAL2 

.COB 


STM 

SERVICES 

MTMSERV 


DESCRIPTION: 


ARGUMENTS : 


BUFFER  -  DSPLY  [X(4096)] 

BUFFER-SIZE  -  DSPLY  [9(5)] 

SYS-STATE  -  DSPLY  [X] 

USER-RET-CODE  -  DSPLY  [X(5)] 

API -GLOBAL-NAME-SEC  -  RECRD 

API -GLOBAL-BUFFER-SEC  -  RECRD 

HOT - MBX-E VENT -BLK  -  DSPLY  [X(2032)3 

COLD-MBX-EVENT-BLK  -  DSPLY  [X(2032)] 

SEND-EVENT-BLK  -  DSPLY  [X(2032)] 

ACK -MBX - EVENT - BLK  -  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  -  DSPLY  [X(80)] 
TEST-MODE-FLAG  -  DSPLY  [X] 


INCLUDE  FILES: 


APIINI 

ALMSGH 

APILCL 

APCNM2 

SRVCDS 

RETSTR 


FOR  INITIATION  PURPOSES 

INITIALIZE  LOCAL  NTM-MESSAGE  VARIABLES. 


THE  APIS  COMMON  LOCAL 
APC  GLOBAL  NAME  DATA. 
SERVICE  CODES  FOR  THE 
THE  APIS  COMMON  LOCAL 


DATA. 

NTM  SERVICE  ROUTINES. 
DATA  FOR  ERROR-RETURNS. 


3-78 
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APIMME  -  API  GLOBAL  NAME  DATA. 

BUFAPI  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  NTH  EVENT  BLOCKS. 

TSTMDE  -  TEST  MODE  FLAG. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


LOCKE F 
GETNAM 
CRTMBX 
RCVMSG 
SETTIM 
WAIT02 
GETMSG 
SNDMSG 
WAIT01 
DELMBX 
RELEVB 
ERRPRO 


PS  620142300 
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NTM/SERV  Module  Docuaent&t i on 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


TWTTW2 

INITIALIZE  UI  LIKE 
UIV  MPU. 

VAX- 11  COBOL 
SUBROUTINE 
INITEX2 
.COB 

NTM 

SERVICES 

NTMSERV 


S  CONNECTION  TO  THE 


ARGUMENTS : 


BUFFER  -  DSPLY  [X(9999)] 

BUFFER-SIZE  -  DSPLY  [9(5)] 
USER-RET-CODE  -  DSPLY  [X(5)3 
API -GLOBAL-NAME-SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT-MBX-EVENT-BLK  -  DSPLY  [X(2032)] 
COLD-MBX -EVENT-BLK  -  DSPLY  [X(2032)] 
SEND- EVENT -BLK  -  DSPLY  [X(2032)] 

ACK -MBX - EVENT-BLK  -  DSPLY  [X(2032>] 
TIMER- EVENT-BLK  -  DSPLY  [X(80)3 
TEST-MODE-FLAG  -  DSPLY  [X] 


INCLUDE  TILES: 


API INI 
ALMSGH 
APILCL 
SRVCDS 
RETSTR 
APCNM1 


FOR  INITIATION  PURPOSES. 

INITIALIZE  LOCAL  NTM -MESSAGE  VARIABLES. 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOC*L  DATA  FOR  ERROR-RETURNS. 
APC  GLOBAL  NAME  DAT* . 


4 


3-80 


m 
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APINME  -  API  GLOBAL  NAME  DATA. 

BUFAPI  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  NTM  EVENT  BLOCK. 

TSTMDE  -  TEST  MODE  FLAG. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE. 


ROUTINES  CALLED: 


GETNAM 

CRTMBX 

SNDMSG 

SETTIM 

WAIT01 

RCVMSG 

WAIT02 

GETMSG 

DELMBX 

ERRPRO 


1  BO 


ir  IMS 


ITM/snv  Module  OoooanUUoa 


■AMS:  INITIL2 

PURPOSE:  INITIALISE  AM  AP ’ ■  OONBSCTXON  TO  AM  AP 

SELECTED  MPU . 

LANGUAGE:  VAX-11  COBOL 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE:  IMITXL2 

SOURCE  FILE  TYPE:  .COB 

HOST:  VAX 

SUBSYSTEM :  NTH 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  MTMSERV 

DESCRIPTION: 


ARGUMENTS : 


BUFFER  -  DSPLY  tX(4096)] 

BUFFER- SIZE  -  DSPLY  [9(5)] 

MPU-NAME  -  DSPLY  tX(3)] 

SYS-STATE  -  DSPLY  [X] 

USER-RET-CODE  -  DSPLY  [X(5)] 

API -GLOBAL-NAME-SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT-MBX-EVENT-BLK  -  DSPLY  [X(2032)] 
COLD- MBX - EVENT - BLK  -  DSPLY  [X(2032)] 
SEND-EVENT-BLK  -  DSPLY  [X(2032)j 
ACK -MPX - EVENT - BLK  -  DSPLY  (X(2032)] 
TIMER -EVENT- BLK  -  DSPLY  [X(80)3 
TEST-MODE-FLAG  -  DSPLY  [X] 


INCLUDE  FILES: 


API INI  -  FOR  INITIATION  PURPOSES. 

ALMSGH  -  INITIALIZE  LOCAL  NTM-MESSAGE  VARIABLES. 
APILCL  -  THE  APIS  COMMON  LOCAL  DATA. 

APCNM2  -  APC  GLOBAL  NAME  DmTA . 


3-82 


PS  62014 
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SR  VCDS 

retstr 

4?  IMS 
BOP API 
APIEVB 
T8TMDK 

errpro 


SEN VICS  CODES  PO*  THE  NTH  SERVICE  ROUTINES 

THE  APIS  OOMPH  LOCAL  DATA  TOR  ERROR  -  RETURNS 

API  GLOBAL  NAME  DATA 

API  GLOBAL  BOTTER  DATA 

NTH  EVERT  BLOCKS 

TEST  NODE  PLAG 

PROCESS  ERROR  INCLUDE  PILE 


ROUTINES  CALLED 


GETNAM 

CRTMBX 

RCVMSG 
SETTIH 
VAIT02 
GETNSG 
SNDHSG 
VAIT01 
DELMBX 
RELEV B 
ERRPRO 


a  - 
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NTH/SERV  Module  Documentation 


MAKE 
PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


IMSTMC2 

GET  THE  SYSGEH 

VAX- 11  COBOL 

SUBROUTINE 

INSTNC2 

.COB 


INSTANCE  NUMBER. 


SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


INSTANCE -NUMBER  -  DSPLY  [XX] 
RET- STATUS  -  DSPLY  [ X( 5  )  ] 
MPU- INSTANCE  -  DSPLY  [XX] 


A0-H182  M2  INTEGRATED  INFORMATION  SUPPORT  SVSTEH  (IISS)  VOLUME  ( 
NETWORK  TRANSACTION.  .  <U>  GENERAL  ELECTRIC  CO 
SCHENECTAOV  NV  PRODUCTION  RESOURCES  CONSU.  .  R  RABBIN 
UNCLASSIFIED  SI  NOV  85  PS-628142288  F/G  12/7 


V 


MICROCOPY  RESOLUTION  TEST  CHART 

NATIONAL  BUREAU  Of  STANDARDS-  1963-A 
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NTM/SERV  Module  Documentat ion 


NAME: 
PURPOSE : 


LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


ISEND2 

SEND  MESSAGE  THAT  WILL  CAUSE  THE  SPECIFIC 

INITIATION  OF  AN 

VAX- 11  COBOL 

SUBROUTINE 

ISEND2 

.COB 


SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


DSTINATION  -  DSPLY  [X(10)l 
LOGICAL-CHANNEL  -  DSPLY  [X(3)3 
TIMEOUT-VALUE  -  DSPLY  [X(15)J 
DATA-TYPE  -  DSPLY  [X] 


INCLUDE  FILES: 


MSGSTR 

APILCL 

SRVCDS 

RETSTR 

APINME 

BUFAPI 

APIEVB 

ERRPRO 


PURPOSE 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
API  GLOBAL  NAME  DATA. 

API  GLOBAL  BUFFER  DATA. 

NTM  EVENT  BLOCKS. 

PROCESS  ERROR  INCLUDE  FILE. 


ROUTINES  CALLED: 
SNDMSG 


3-85 


PS  620142300 
1  November  1985 


SETTIM 

VAIT01 

RCVMSG 

WAIT02 

GETMSG 

CHLTIM 

RELEVB 

ERRPRO 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


LOGOFF2 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

VAX- 11  COBOL 

SUBROUTINE 

L0G0FF2 

.COB 


SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ACCEPTS  LOGOFF  DATA  FROM  THE  UI  AND  FORWARDS 
A  MESSAGE  TO  THE  MONITOR  AP  FOR  UPDATING  THE 
IISS  LOGON  TABLE. 


ARGUMENTS : 


TERMINAL-ID  -  DSPLY  [X(2)] 

USER-NAME  -  DSPLY  [X(8)] 

ROLE-NAME  *  DSPLY  [X(10)] 

LOG -RET -CODE  -  DSPLY  [X(5)] 

API -GLOBAL-NAME-SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT -MBX - EVENT - BLK  -  DSPLY  [X(2032)] 
COLD-MBX- EVENT -BLK  -  DSPLY  [X(2032)] 
SEND- EVENT -BLK  -  DSPLY  [X(2032)3 
ACK -MBX - EVENT - ELK  «  DSPLY  [X(2032)] 
TIMER -EVENT -BLK  -  DSPLY  [X(80)l 


INCLUDE  FILES: 


SRVRET 

SRVCD2 

RETSTR 

APINME 

BUFAPI 


NTM  SERVICES  STATUS  CODES . . 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
API  GLOBAL  NAME  DATA. 

API  GLOBAL  BUFFER  DATA. 


3-87 
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APIEVB  -  BTM  EVEBT  BLOCKS. 

ERRPRO  -  PROCESS  ERROR  IBCLUDE  FILE. 


ROUTIRES  CALLED: 


BSEBD2  -  SEBD  MESSAGE  TO  AB  AP  IB  THE  IISS. 
ERRPRO 


3-88 


PS  620142300 
1  November  1985 


NTM/SERV  Module  Docuaentat ion 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


L0G0N2 

SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

VAX- 11  COBOL 

SUBROUTINE 

L0G0N2 

.COB 


HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ACCEPTS  LOGON  DATA  FROM  THE  UI  AND  FORWARDS 
A  MESSAGE  TO  THE  MONITOR  AP  FOR  UPDATING  THE 
IISS  LOGON  TABLE.  WAITS  ON  THE  RESPONSE  FROM 
MONITOR  BEFORE  RETURNING  CONTROL  TO  THE  UI . 


ARGUMENTS : 


TERMINAL-ID  -  DSPLY  [X(2)] 

USER-NAME  -  DSPLY  [X(8)] 

ROLE-NAME  -  DSPLY  [X(10)] 
SESSION-START-TIME  -  DSPLY  [X(23)3 
CHAN-RANGE-START  -  DSPLY  tX(3)] 
CHAN-RANGE-END  -  DSPLY  [X(3)] 
LOG-RET-CODE  -  DSPLY  [X(5)3 
API -GLOBAL-NAME-SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT-MBX-EVENT-BLK  -  DSPLY  [X(2032)3 
COLD- MBX -EVENT - BLK  -  DSPLY  [X(2032)] 
SEND- EVENT -BLK  -  DSPLY  [X( 2032)3 
ACK -MBX -EVENT -BLK  -  DSPLY  [X(2032)3 
TIMER -EVENT -BLK  -  DSPLY  [X(80)3 
TEST-MODE-FLAG  -  DSPLY  [Xj 


INCLUDE  FILES: 
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SRVRET 

RETSTR 

SRVCD2 

APIRME 

BUFAP1 

APIEVB 

TSTMDE 

ERRPRO 


NYM  SERVICES  STATUS  CODES. 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURKS . 
SERVICE  CODES  FOR  THE  MTM  SERVICE  ROUTIRES. 
API  GLOBAL  MAKE  DATA. 

API  GLOBAL  BUFFER  DATA. 

HTM  EVERT  BLOCKS. 

TEST  MODE  FLAG. 

PROCESS  ERROR  INCLUDE  FILE. 


ROUTINES  CALLED: 


HSEHD2  -  SEND  MESSAGE  TO  AH  AP  IM  THE  IISS. 

RCV2  -  RECEIVE  MESSAGES  FROM  OTHER  AP'S  IH  THE  IISS  . 

ERRPRO 


t 

I 


) 

I 
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NTM/SERV  Module 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


ARGUMENTS : 


CALL-NAME  -  DSPLY 


Documen tat 1 on 


MBXLG2 

PURPOSE  NOT  KNOWN  -  ACTIVE  CODE. 

VAX- 11  COBOL 

SUBROUTINE 

MBXLG2 

.COB 

NTM 

SERVICES 

NTMSERV 


tX(72) ] 


3-91 


i 


'XV.V. 
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MTO/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


MBXLOG 

PURPOSE  MOT  KMOVN  -  ACTIVE  CODE. 

VAX-11  COBOL 

SUBROUTINE 

MBXLOG 

.COB 


HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  MTMSERV 


DESCRIPTION: 


ARGUMENTS : 

MSG-BUFFER  -  DSPLY  [X(72)] 


ROUTINES  CALLED: 


GETNAM 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


NSEND2 

SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

VAX- 11  COBOL 

SUBROUTINE 

NSEND2 

.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION : 


ARGUMENTS : 


DSTINATION  -  DSPLY  [X(10)] 
LOGICAL-CHANNEL  -  DSPLY  [X(3)] 
TIMEOUT-VALUE  -  DSPLY  [X(15)] 
DATA-TYPE  -  DSPLY  [X] 


INCLUDE  FILES: 


MSGSTR  -  PURPOSE 

APILCL  -  THE  APIS  COMMON  LOCAL  DATA. 

SRVCDS  -  SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 

RETSTR  -  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 

APINME  -  API  GLOBAL  NAME  DATA. 

BUFAPI  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  NTM  EVENT  BLOCKS. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE. 


ROUTINES  CALLED: 


SNDMSG 

SETTIM 
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VAIT01 
RCVMSG 
WAIT02 
GETMSG 
CNLTIM 
RELEV B 
ERRPRO 


CALLED  DIRECTLY  BY: 


CHGR0L2 

GDACK2 

GETUSR2 

L0G0FF2 
LOGON 2 
SIGABT2 
SIGERR2 

WHTHST2 


-  CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED  ON. 

-  SENDS  GD  ACK  HESSAGE  TO  LOCAL  MPU. 

-  RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL.  AND 

USER  NAME. 

-  SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP. 

-  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

-  SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

-  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 

-  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN  AP 

RESIDES. 


USED  IN  MAIN  PROGRAM(S): 


CHGR0L2 

GDACK2 

GETUSR2 

L0G0FF2 
LOGON 2 
SIGABT2 
SIGERR 
WHTHST 


CHANGE  THE  ROLE  UNDER  WHICH  A  USER  LOGGED  ON. 
SENDS  GD  ACK  MESSAGE  TO  LOCAL  MPU. 

RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL.  AND 
USER  NAME. 

SENDS  LOGOFF  MESSAGE  TO  THE  MONITOR  AP . 

SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 
CALL  SIGERR2 
CALL  WHTHST2 
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NTH/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


POSTCOM 

WRITE  "CLEAN-UP* 

COMMAND  FILE 

VAX-11  COBOL 

SUBROUTINE 

POSTCOM 

.COB 

NTM 

SERVICES 
:  NTMSERV 


CONTROL  CARDS  TO  THE 


DESCRIPTION: 


ARGUMENTS : 

FILENAM  -  DSPLY  [X(30)] 

ROUTINES  CALLED: 

RCLFILE  -  DO  COMMAND  FILE  OPERATIONS  FOR  RCLE 

CAT.  ,JD  DIRECTLY  BY: 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

USED  IN  MAIN  PROGRAM ( S ) : 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ROUTINES  CALLED: 


RCLFILI  -  DO  COMMAND  FILE  OPERATIONS  FOR  RCLE 


PRECOM 

WRITE  " SET-UP “  CONTROL  CARDS  TO  THE 

COMMAND  FILE 

VAX- 11  COBOL 

PROGRAM 

PRECOM 

.COB 

NTM 

SERVICES 

NTMSERV 


CALLED  DIRECTLY  BY: 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 

USED  IN  MAIN  PROGRAM ( S ) : 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


QSEND2 

SEND  MESSAGES  TO  OTHER  APS  IN  THE  IISS 
FROM  QSERVER  AP'S. 

VAX- 11  COBOL 
SUBROUTINE 
QSEND2 
.COB 


NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


THIS  ROUTINE  IS  A  PRELIMINARY  VERSION  OF  THE  SEND* 
SERVICE  FOR  THE  QSERVER.  CURRENTLY,  IT  ONLY  * 

SUPPORTS  QSERVERS  THAT  SERVICE  ONE  REQUEST  AT  A  * 
TIME.  * 


ARGUMENTS : 


DSTINATION  «  DSPLY  [X( 10) ] 
LOGICAL-CHANNEL  -  DSPLY  [X(3)3 
TIMEOUT-VALUE  «  DSPLY  [X(15)3 
DATA-TYPE  -  DSPLY  [X] 

MESSAGE-TYPE  -  DSPLY  [X(2)] 

SEND-SIZE  -  DSPLY  [9(5)] 

USER-DATA  -  RECRD 

ACCEPT-STATUS  -  DSPLY  [X(5)3 

API -GLOBAL-NAME-SEC  -  RECRD 

API -GLOBAL-BUFFER-SEC  -  RECRD 

HOT -MBX -EVENT -BLK  -  DSPLY  [X(2032)] 

COLD-MBX-EVENT-BLK  -  DSPLY  [X(2032)] 

SEND- EVENT -BLK  -  DSPLY  [X(2032)] 

ACK -MBX -EVENT -BLK  -  DSPLY  [X(2032)] 
TIMER-EVENT-BLK  -  DSPLY  [X(80)3 


INCLUDE  FILES: 


■UHPJUUP 
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MSGSTR 

APILCL 

SRVCDS 

RETSTR 

APINME 

BUFAPI 

APIEVB 

ERRPRO 


PURPOSE 

THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTH  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
API  GLOBAL  NAME  DATA. 

API  GLOBAL  BUFFER  DATA. 

MTM  EVENT  BLOCKS. 

PROCESS  ERROR  INCLUDE  FILE. 


ROUTINES  CALLED: 


SNDMSG 

SETTIM 

WAIT01 

RCVMSG 

VAIT02 

GETMSG 

CNLTIM 

RELEVB 

ERRPRO 
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NTM/SERV  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


RCLE 

REMOTE  COMPILE  AND  LINE  EXPERT  DRIVER 

VAX- 11  COBOL 

PROGRAM 

RCLE 


.COB 


HOST:  VAX 

SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


RCLE  IS  INITIATED  BY  * SNDRCLE "  NTM  SERVICE.  IT  BUILDS  A  * 
COMMAND  FILE  WHICH  INCLUDES  THE  SYSTEM  CONTROL  CARDS  FOUND 
IN  THE  INITIATING  MESSAGE.  THIS  COMMAND  FILE  IS  THEN  RUN  AS 
A  DETACHED  PROCESS.  WHEN  IT  COMPLETES.  RCLE  WILL  RETURN  A 
MESSAGE  CONTAINING  THE  NAME  OF  THE  LOG  FILE. 

MODIFIED:  7/19/85  TO  NOT  CALL  GETUSER.  IT  NOW  REPLIES  TO 

RCV . 


INCLUDE  FILES: 


NTM  SERVICES  STATUS  CODES . . 

THE  APIS  COMMON  LOCAL  DATA. 

NTM  EVENT  BLOCKS 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
PROCESS  ERROR  INCLUDE  FILE 


SRVRET 

APILCL 

APIEVB 

RETSTR 

ERRPRO 


ROUTINES  CALLED: 


INITAL 

RCV 

RCLFILE  -  DO  COMMAND  FILE  OPERATIONS  FOR  RCLE 
PRECOM  -  WRITE  "SET-UP"  CONTROL  CARDS  TO  THE  COMMAND  FILE 
POSTCOM  -  WRITE  "CLEAN-UP"  CONTROL  CARDS  TO  THE  COMMAND 
FILE 

SYSSGETJPI 

SYSSCREPRC 
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SETTIM 
WAITOl 
NS  END 

TRMHAT  -  CALL  TRMKAT2 
ERRPRO 
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NAME :  RCLFILE 

PURPOSE:  DO  COMMAND  FILE  OPERATIONS  FOR  RCLE 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE :  SUBROUTINE 

SOURCE  FILE:  RCLFILE 

SOURCE  FILE  TYPE:  .COB 

HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 

DESCRIPTION: 


ARGUMENTS : 


C-CARD  -  DSPLY  [X(72)] 
REQUEST  -  DSPLY  [X(5)] 


CALLED  DIRECTLY  BY: 


POSTCOM  -  WRITE  "CLEAN-UP"  CONTROL  CARDS  TO  THE  COMMAND 
FILE 

PRECOM  -  WRITE  "SET-UP"  CONTROL  CARDS  TO  THE  COMMAND  FILE 

RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


USED  IN  MAIN  PROGRAM(S): 


RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


nnninnRPRnBv^stgnvTmcsvnnmmroTOtn 
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NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


RCV2 

RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE 
IISS  . 

VAX- 11  COBOL 

SUBROUTINE 

RCV2 

.COB 


HOST: 

SUBSYSTEM :  NTH 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION : 


ARGUMENTS : 


LOGICAL-CHANNEL  -  DSPLY  [X(3>] 
WAIT-FLAG  -  DSPLY  [X] 

MSG-SOURCE  -  DSPLY  [X(10)3 
MESSAGE-TYPE  -  DSPLY  [X(2)3 
DATA-LENGTH  -  DSPLY  [9(5)3 
USER-DATA  -  RECRD 
ACCEPT-STATUS  -  DSPLY  [X(5)3 
MSG- SERIAL-NUMBER  -  DSPLY  [X(7)3 
API -GLOBAL-NAME-SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT-MBX-EVENT-BLK  -  DSPLY  [X(2032)3 
COLD-MBX-EVENT-BLK  -  DSPLY  [X(2032)3 
SEND-EVENT-BLK  -  DSPLY  [X(2032)3 
ACK-MBX-EVENT-BLK  -  DSPLY  [X(2032)3 
TIMER-EVENT-BLK  -  DSPLY  [X(80)3 
TEST -MODE -FLAG  -  DSPLY  (X3 


INCLUDE  FILES: 


MSGSTR 


PURPOSE 
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APILCL 
SRVCDS 
RETSTR 
APINME 
BUFAPI 
APIEVB 
TSTMDE 
ERR PRO 


-  THE  APIS  COMMON  LOCAL  DATA. 

-  SERVICE  CODES  FOR  THE  NTH  SERVICE  ROUTINES. 

-  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 

-  API  GLOBAL  NAME  DATA. 

-  API  GLOBAL  BUFFER  DATA. 

-  NTH  EVENT  BLOCKS. 

-  TEST  MODE  FLAG. 

-  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


RCVMSG 

VAIT02 

WAIT01 

GETMSG 

ERRPRO 


CALLED  DIRECTLY  BY: 


GETUSR2  -  RETURNS  ORIGINAL  SOURCE ,  LOGICAL  CHANNEL.  AMD 

USER  NAME. 

LOGON 2  -  SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

WHTHST2  -  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AM  AP 

RESIDES. 


USED  IN  MAIN  PROGRAM(S) : 


GETUSR2 

LOGON 2 
WHTHST 


RETURNS  ORIGINAL  SOURCE.  LOGICAL  CHANNEL.  AND 
USER  NAME. 

SENDS  LOGON  MESSAGE  TO  THE  MONITOR  AP. 

CALL  WHTHST2 
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NTM/SERV  Module  Documentation 


MAKE: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


SIGABT2 

SIGNAL  THE  MPU  TO  ABORT  A  CHILD  AP 

VAX- 11  COBOL 

SUBROUTINE 

SIGABT2 

.COB 

NTH 

SERVICES 

NTMSERV 


NTH  SERVICE  TO  SIGNAL  ABORT  CHILD  TO  THE  MPU. 

AFTER  THIS  PROCESS,  THE  MPU  PROCESS  "ABORT"  TAKES  OVER. 


TELL  THE  LOCAL  MPU  TO  ABORT  A  CHILD. 
THE  SAME  OR  DIFFERENT  CLUSTER / HOST . 

ARGUMENTS : 


THE  CHILD  MAY  BE  ON 


AP-NAME  -  DSPLY  [X( 10) 3 


INCLUDE  FILES: 

SRVRET 

RETSTR 

SRVCD2 

APILCL 

APINME 

BUFAPI 

APIEVB 

TSTMDE 

ERRPRO 


NTM  SERVICES  STATUS  CODES.. 

THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS 
SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
THE  APIS  COMMON  LOCAL  DATA. 

API  GLOBAL  NAME  DATA. 

API  GLOBAL  BUFFER  DATA. 

NTM  EVENT  BLOCKS. 

TEST  MODE  FLAG. 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


NSEND2 

ERRPRO 


-  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


SIGERR 

CALL  SIGERR2 
C 

FUNCTION 
I  NT  () 

SIGERR 
•  C 


SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


SYNOPSIS 

CALL  SIGERR  USING  ERROR-CODE, 

SEVERITY-LEVEL, 
ERROR-DESCRIPTION . 
RETURN-CODE . 


INPUTS /OUTPUTS: 

INPUTS : 

ERROR-CODE  PIC  X(5). 

SEVERITY -LEVEL  PIC  X. 

ERROR-DESCRIPTION  PIC  X(72). 

OUTPUTS : 

RETURN-CODE  PIC  X(5). 

DESCRIPTION 

SIGERR  IMPLIMENTS  A  TWO-STEP  CALL  TO  SIGERR2 . 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS). 


ARGUMENTS: 


A  -  CHAR  * 
B  -  CHAR  • 
C  -  CHAR  • 
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D  -  CHAR  • 


INCLUDE  FILES: 


APIMME  -  API  GLOBAL  NAME  DATA. 
BUFAPI  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  NTM  EVENT  BLOCKS. 


ROUTINES  CALLED: 


APACCT 

SIGERR2  -  SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 

ORIGINAL  SOURCE. 


> 


3-106 


PS  620142300 
1  November  1985 
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NAME: 
PURPOSE : 


LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


SIGERR2 

SENDS  AN  ERROR  MESSAGE  TO  MONITOR  AND  TO 
ORIGINAL  SOURCE. 

VAX- 11  COBOL 
SUBROUTINE 
SIGERR2 
•  COB 


SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


ACCEPTS  ERROR  DATA  FROM  AN  AP  AND  FORWARDS 
A  MESSAGE  TO  THE  MONITOR  AP  FOR  ITS  ERROR 
REPORTING  AND  ONE  TO  THE  ORIGINAL  SOURCE  OF  THE 
AP. 


ARGUMENTS : 


ERROR -CODE  -  DSPLY  [X(5)] 
SEVERITY-LEVEL  -  DSPLY  [X] 

ERROR -DESCRIPTION  -  DSPLY  [X(72)3 
RTN-CODE  -  DSPLY  [X(5)l 
API -GLOBAL-NAME -SEC  -  RE CRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT -MBX- EVENT -BLK  -  DSPLY  [X(2032)3 
COLD - MBX - EVENT - BLK  «  DSPLY  [X(2032>] 
SEND-EVENT-BLK  -  DSPLY  [X(2032)3 
ACK-MBX -EVENT -BLK  -  DSPLY  [X(2032)] 
TIMER -EVENT -BLK  -  DSPLY  tX(80)3 


INCLUDE  FILES: 


SRVRET  -  NTM  SERVICES  STATUS  CODES . . 

RETSTR  -  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR - RETURNS . 

SRVCD2  -  SERVICE  CODES  FRO  THE  NTM  SERVICE  ROUTINES. 
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APILCL  -  THE  APIS  COMMON  LOCAL  DATA. 

APINME  -  API  GLOBAL  MAKE  DATA. 

BUT API  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  NTH  EVERT  BLOCKS. 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE. 


ROUTINES  CALLED: 


NSEND2  -  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

ERRPRO 


CALLED  DIRECTLY  BY: 


SIGERR  -  CALL  SIGERR2 


USED  IN  MAIN  PROGRAM(S) : 


SIGERR  -  CALL  SIGERR2 
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NAME: 
PURPOSE : 


LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


SNDRCLE 

REMOTE  COMPILE  AND  LINK  EXPERT  CALLING 

SERVICE 

VAX- 11  COBOL 

SUBROUTINE 

SNDRCLE 

.COB 


NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ARGUMENTS : 


NODE  -  DSPLY  [X(3)] 
CHANNEL  -  DSPLY  [X(3)] 
CTL-CARD  -  DSPLY  [X(1096)l 
RET-STATUS  -  DSPLY  [X(5)l 


INCLUDE  FILES 


SRVRET 


-  NTM  SERVICES  STATUS  CODES 


ROUTINES  CALLED: 


I  SEND 
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NAME :  TRMNAT 

PURPOSE :  CALL  TRMMAT2 

LANGUAGE :  C 

MODULE  TYPE :  FUNCTION 

FUNCTION  TYPE:  I NT  () 

SOURCE  FILE :  TRMNAT 

SOURCE  FILE  TYPE:  .C 

HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 

DESCRIPTION: 


SYNOPSIS 

CALL  TRMNAT  USING  USER-TERMINATE-STATUS . 


INPUTS /OUTPUTS: 

INPUTS : 

USER-TERMINATE-STATUS  PIC  X. 

OUTPUTS : 

DESCRIPTION 

TRMNAT  IMPLIMENTS  A  TWO-STEP  CALL  TO  TRMNAT2 . 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS ) . 

ARGUMENTS : 


A  -  CHAR  * 


INCLUDE  FILES: 


APINME  -  API  GLOBAL  NAME  DATA. 

APIEVB  -  NTM  EVENT  BLOCKS. 


<  t  .»  I 
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ROUTINES  CALLED: 


APACCT 

TRMNAT2  -  TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 


CALLED  DIRECTLY  BY: 


RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


USED  IN  MAIN  PROGRAM(S): 


RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 
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NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


TRMRAT2 

TERMINATE  AN  AP'S  CONNECTION  TO  THE  IISS. 

VAX-11  COBOL 

SUBROUTINE 

TRMNAT2 

.COB 


HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


*  ARGUMENTS : 


USER -TERM I NATE -STATUS  -  DSPLY  [X] 

API -GLOBAL-NAME-SEC  -  RECRD 
HOT -MBX -EVENT -BLK  -  DSPLY  [X(2032)3 
COLD-MBX-EVENT-BLK  -  DSPLY  [X(2032)l 
SEND -EVENT -BLK  -  DSPLY  [X(2032>] 
ACK-MBX-EVENT-BLK  -  DSPLY  [X(2032>] 

*  TIMER -EVENT -BLK  -  DSPLY  IX(80)) 


INCLUDE  FILES: 


ADMSGH 

APILCL 

SRVCDS 

RETSTR 

APINME 

APIEVB 

ERRPRO 


THE  APIS  COMMON  LOCAL 
THE  APIS  COMMON  LOCAL 
SERVICE  CODES  FOR  THE 
THE  APIS  COMMON  LOCAL 
API  GLOBAL  NAME  DATA. 
NTM  EVENT  BLOCKS. 
PROCESS  ERROR  INCLUDE 


DATA  FOR  ERROR-RETURNS. 
DATA. 

NTM  SERVICE  ROUTINES. 
DATA  FOR  ERROR-RETURNS. 


FILE 


ROUTINES  CALLED: 
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DELMBX 
EMDRUN 
SMDMSG 
SETTIM 
WAIT01 
RELEV B 
ERRPRO 


CALLED  DIRECTLY  BY: 


TRMNAT  -  CALL  TRMNAT2 


USED  IN  MAIN  PROGRAM(S) : 


RCLE  -  REMOTE  COMPILE  AND  LINK  EXPERT  DRIVER 


I 


1 


I 

■ 
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NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


TRMNAX 

CALL  TRMNAX2 

C 

FUNCTION 
INT  () 

TRMNAX 

•  C 


SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRI PTION : 


SYNOPSIS 

CALL  TRMNAX  USING  USER-TERMINATE-STATUS . 


INPUTS /OUTPUTS : 

INPUTS : 

USER-TERMINATE-STATUS  PIC  X . 

OUTPUTS : 

DESCRIPTION 

TRMNAX  IMPLIMENTS  A  TWO-STEP  CALL  TO  TRMNAX2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS). 

ARGUMENTS : 


A  -  CHAR  * 


ROUTINES  CALLED: 


APACCT 

TRMNAX2  -  TERMINATE  COMM ' S  CONNECTION  TO  THE  IISS. 


* 

V 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


TRMNAX2 

TERMINATE  COMM'S  CONNECTION  TO  THE  IISS. 

VAX- 11  COBOL 

SUBROUTINE 

TRMNAX2 

.COB 


SUBSYSTEM :  NTM 

SUBDIRECTORY :  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 


DESCRIPTION: 


SINCE  COMM  DELETES  ITS  INPUT  MAILBOX,  TRMNAX  HAS  ONLY  * 
TWO  FUNCTIONS.  THEY  ARE:  SEND  THE  "AP  DYING"  MESSAGE  * 
TO  THE  COMM  APC  AND  THEN  CALL  "ENDRUN"  TO  TERMINATE  THE  * 
AP.  • 


ARGUMENTS : 


USER-TERMINATE-STATUS  -  DSPLY  [X] 
MPU- INSTANCE  -  DSPLY  [XX] 


INCLUDE  FILES: 


ADMSGH 

RETSTR 

APILCL 

SRVCDS 

COMAPC 

ERRPRO 


THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
THE  APIS  COMMON  LOCAL  DATA. 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 
HARD  CODED  APC  NAMES  FOR  COMM. 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


GETNAM 

ENDRUN 
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SKDMSG 

SETTIM 

VAIT01 

RELEVB 

ERRPRO 


CALLED  DIRECTLY  BY: 

TRMNAX  -  CALL  TRMNAX2 

USED  IN  MAIN  PROGRAM(S): 
TRMNAX  -  CALL  TRMNAX2 
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NAME :  TSTMOD 

PURPOSE:  CALL  COBOL  ROUTINE  TSTM0D2 

LANGUAGE :  C 

MODULE  TYPE:  FUNCTION 

FUNCTION  TYPE:  INT  () 

SOURCE  FILE :  TSTMOD 

SOURCE  FILE  TYPE:  .C 

HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 

DESCRIPTION: 


SYNOPSIS 

CALL  TSTMOD  USING  TEST-STATUS, 

RETURN -CODE. 


INPUTS/OUTPUTS : 

INPUTS : 

TEST-STATUS  PIC  X . 

OUTPUTS : 

RETURN-CODE  PIC  X(5). 

DESCRIPTION 

TSTMOD  IMPLIMENTS  A  TWO-STEP  CALL  TO  TSTM0D2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN’T  ALLOW  EXTERNAL 
DATA  AREAS). 

ARGUMENTS : 


A  -  CHAR  * 

B  -  CHAR  * 


INCLUDE  FILES: 


APIEVB  -  NTM  EVENT  BLOCKS. 
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ROUTINES  CALLED: 


APAGCT 

TSTM0D2  -  SET/ RESET  THE  TEST -MODE- FLAG . 


4.1 

t 

t 

t| 

II 


4 

i' 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


TSTM0D2 

SET/RESET  THE  TEST-MODE-FLAG. 

VAX- 11  COBOL 

SUBROUTINE 

TSTM0D2 

.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


TSTMOD2  IS  TO  BE  CALLED  BY 

THE  UI  TO  SET/RESET  THE  TEST-MODE-FLAG  .  WHEN  SET 
THE  UI  WILL  RECEIVE  ASYNCHONOUS  ERROR  MESSAGES  FOR 
THE  USER  IT  IS  SERVICING.  WHEN  THE  TEST -MODE -FLAG 
IS  OFF.  THE  ASYNCH  ERROR  MESSAGES  WILL  BE  DISCARDED 


ARGUMENTS : 

TEST-STATUS  -  DSPLY  [X] 

INCLUDE  FILES: 

SRVCD2  -  SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 

TSTMDE  -  TEST  MODE  FLAG. 

CALLED  DIRECTLY  BY: 

TSTMOD  -  CALL  COBOL  ROUTINE  TSTM0D2 

USED  IN  MAIN  PROGRAM(S) : 
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TSTMOD 


-  CALL  COBOL  ROUTINE  TSTM0D2 


L_ 
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NAME:  WHTHST 

PURPOSE :  CALL  WHTHST2 

LANGUAGE :  C 

MODULE  TYPE:  FUNCTION 

FUNCTION  TYPE:  I NT  () 

SOURCE  FILE:  WHTHST 

SOURCE  FILE  TYPE:  .C 

HOST: 

SUBSYSTEM :  NTM 

SUBDIRECTORY:  SERVICES 

DOCUMENTATION  GROUP:  NTMSERV 

DESCRIPTION: 


SYNOPSIS 

CALL  WHTHST  USING  REQ-AP-NAME, 

AP-HOST-NAME . 
RETURN-STATUS . 


INPUTS /OUTPUTS: 

INPUTS : 

REQ-AP-NAME  PIC  X(10). 

OUTPUTS : 

AP-HOST-NAME  PIC  X(3). 

RETURN-STATUS  PIC  X(5). 

DESCRIPTION 

WHTHST  IMPLIMENTS  A  TWO-STEP  CALL  TO  WHTHST2 , 
ADDING  THE  ADDRESSES  OF  GLOBAL  AREAS  TO  THE 
PARAMETER  LIST  (IBM  COBOL  DOESN'T  ALLOW  EXTERNAL 
DATA  AREAS). 

ARGUMENTS : 


A  -  CHAR  * 
B  -  CHAR  * 
C  -  CHAR  * 


PS  620142500 
1  November  1985 


INCLUDE  FILES: 

APINME  -  API  GLOBAL  NAME  DATA. 
BUFAPI  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  HTM  EVENT  BLOCKS. 


ROUTINES  CALLED: 


APACCT 

WHTHST2 


-  RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN  AP 
RESIDES. 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


WHTHST2 

RETURNS  THE  NAME  OF  THE  HOST  ON  WHICH  AN 
AP  RESIDES. 

VAX- 11  COBOL 
SUBROUTINE 
VHTHST2 
.COB 

NTM 

SERVICES 

NTMSERV 


DESCRIPTION: 


ACCEPTS  AN  AP  NAME  FROM  A  REQUESTING  AP  AND  RETURNS 
THE  NAME  OF  THE  HOST  ON  WHICH  THE  SPECIFIED  AP  RESIDES. 
IF  THE  INFO  IS  NOT  FOUND,  AN  UNSUCCESSFUL  STATUS  CODE 
IS  RETURNED  TO  THE  CALLING  AP . 


ARGUMENTS : 


REQ-AP-NAME  -  DSPLY  tX(10)] 
AP-HOST-NAME  -  DSPLY  [X(3)] 
RETURN-STATUS  -  DSPLY  [ X( 5) ] 

API -GLOBAL-NAME -SEC  -  RECRD 
API -GLOBAL-BUFFER-SEC  -  RECRD 
HOT-MBX - EVENT -BLK  -  DSPLY  [X(2032)] 
COLD -MBX - EVENT - BLK  -  DSPLY  [X(2032)l 
SEND-EVENT-BLK  -  DSPLY  [X(2032)] 
ACK-MBX-EVENT-BLK  -  DSPLY  [X(2032)] 
TIMER -EVENT -BLK  -  DSPLY  [X(80)3 
TEST-MODE-FLAG  -  DSPLY  [X] 


INCLUDE  FILES: 


RETSTR 

SRVRET 

SRVCD2 


THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 
NTM  SERVICES  STATUS  CODES . . 

SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 


aWVaW -W -.\%YvVs' 
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APINME  -  API  GLOBAL  NAME  DATA. 

BUFAPI  -  API  GLOBAL  BUFFER  DATA. 

APIEVB  -  NTM  EVENT  BLOCKS. 

TSTMDE  -  TEST  MODE  FLAG. 

ERR PRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


NSEND2  -  SEND  MESSAGE  TO  AN  AP  IN  THE  IISS. 

RCV2  -  RECEIVE  MESSAGES  FROM  OTHER  APS  IN  THE  IISS  . 

ERRPRO 


CALLED  DIRECTLY  BY: 


WHTHST  -  CALL  WHTHST2 


USED  IN  MAIN  PROGRAM(S) : 


WHTHST 


CALL  WHTHST2 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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NTM/SERV  Include  File  Description 


FILE  NAME:  ADMSGH 

PURPOSE:  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


MODIFIED  8/20/84  INITALIZE  ALL  LOCAL  VARAIBLES  TO  SPACES 

OR  0 

MODIFIED  5/24/85  CLEAN-UP. 


PS  620142300 
1  November  1985 


NTM/SERV  Include  File  Description 


FILE  NAME:  ALMSGH 

PURPOSE:  INITIALIZE  LOCAL  NTH-MESSAGE  VARIABLES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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NTM/SERV  Include  File  Deecription 


FILE  MAKE:  APCTTM1 

PURPOSE:  A PC  GLOBAL  RAME  DATA. 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION : 


MODIFIED  8/24/84  MSG-RCV-BOFFER  TO  OCCUR  20  TIMES. 

MODIFIED  10/25/83  TO  MOVE  AP'S  NUMBER  OF  MAILBOXES  VALUE  TO 

TO  THE  SYSTEM  STATE  BLOCK. 

RESTORED  11/22/83 

MODIFIED  12/21/83  FOR  ACK  MAILBOX  VALUES. 

MODIFIED  1/30/84  FOR  EXPANDED  AP  NAME. 

MODIFIED  2/01/84  PARTITIONED  FROM  OLD  APISEC.INC  TO  REDUCE 

STORAGE  IN  SERVICES. 

MODIFIED  7/05/84  REMOVED  EXTERNAL  FLAG.  APM 

MODIFIED  5/24/85  CLEAN-UP _ 6/3/85  CLEANUP  CLEANED  UP. 

MODIFIED  6/14/85  PRONME  CONTAINS  ONLY  APNAME  AND  INSTANCE 
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NTM/SERV  Include  File  Description 


FILE  NAME: 
PURPOSE: 
LANGUAGE : 


APCNM2 

A PC  GLOBAL  NAME  DATA 
VAX-11  COBOL 


DESCRIPTION: 


MODIFIED  10/06/83  TO  INCLUDE  INITEX-RES-NOT-AVAIL. 

MODIFIED  11/02/83  TO  INCLUDE  VHTHST-  CODES. 

MODIFIED  1/09/84  TO  CHANGE  ERROR  CODES  TO  PIC  X(5)  AND  TO 

ELIMINATE  ALPHA  CHARACTERS. 

MODIFIED  1/26/84  TO  ADD  SERVICE -SUCCESS  (GENERIC)  AND 
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NTM/SERV  Include  File  Description 

FILE  MAKE:  APIEVB 
PURPOSE:  HTM  EVENT  BLOCKS 

LANGUAGE:  C 

DESCRIPTION: 
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NTM/SERV  Include  File  Description 


FILE  NAME:  API INI 

PURPOSE:  FOR  INITIATION  PURPOSES 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


28  Jan  84  :  changes  for  longer  ap  name 
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NTM/SERV  Include  File  Description 


FILE  MAKE:  APILCL 

PURPOSE:  THE  APIS  COMMON  LOCAL  DATA 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


MODIFIED  8/24/63  TO  UP  THE  SIZE  OF  MAX-IN-RCV-BUFFER  FROM 

10 

TO  20. 

MODIFIED  TO  ADD  VALUES  FOR  SYSTEM  COMMAND 

CATEGORIES . 
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NTM/SERV  Include  File  Description 


FILE  NAME:  APINME 

PURPOSE:  API  GLOBAL  NAME  DATA 

LANGUAGE:  C 

DESCRIPTION: 
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NTM/SERV  Include  Pile  Description 


FILE  NAHE:  BUFAPI 

PURPOSE:  API  GLOBAL  BUFFER  DATA 

LANGUAGE :  C 

DESCRIPTION: 
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NTM/SERV  Include  File  Description 


FILE  NAME:  GOMAPC 

PURPOSE:  HARD  CODED  APC  NAMES  FOR  COMM 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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NTM/SERV  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 
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VTM/SERV  Include  File  Description 


FILE  NAME:  FILES: 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET-OODE-5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA ' S 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-SUCC 
SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY -NOT -FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 
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NTM/SERV  Include  File  Description 


FILE  NAME:  INICMD 

PURPOSE:  INITIALIZATION  MESSAGE  FORMAT 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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NTM/SERV  Include  File  Description 


FILE  NAME:  MSGSTR 
PURPOSE :  PURPOSE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  9/23/83 


MODIFIED  10/06/83 
MODIFIED  11/22/83 
MODIFIED  1/12/84 
MODIFIED  1/30/84 
MODIFIED  2/08/84 
MODIFIED  8/20/84 

MODIFIED  9/20/84 
MODIFIED  5/24/85 


TO  IDENTIFY  ERROR  CODES  AS  RETURNED  VIA 
SNDSAP .  NOTE  -  NO  NACK  IS  SENT  -  ALSO 
CHANGED  RESOURCE -FULL  VALUE  TO  33. 

TO  ADD  VALUE  FOR  SYSTEM  STATE  MESSAGE. 
RESTORED  FROM  HARD  COPY. 

TO  HANDLE  FIVE  CHAR  ERROR  CODE. 

FOR  EXPANDED  AP  NAME. 

TO  RECOGNIZE  ”J*  AS  A  PAIRED  MESSAGE. 
INITALIZE  ALL  LOCAL  VARAIBLES  TO  SPACES 
OR  0 

ADDED  IBM  NAMES  TO  NTMNAME .  BCS  APM 

CLEAN-UP . 
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NTM/SERV  Include  File  Description 


FILE  NAME:  OF 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET-CODE-5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET -CODE  FOR  GETUSR-NOT-SUCC 
SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY-NOT-FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 
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MTM/SERV  Include  File  Description 


FILE  NAME:  RETSTR 

PURPOSE:  THE  APIS  COMMON  LOCAL  DATA  FOR  ERROR-RETURNS. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  8/20/84  INITALIZE  ALL  LOCAL  VARAIBLES  TO  SPACES 

OR  0 

MODIFIED  5/24/85  CLEAN-UP. 
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NTH/SERV  Include  File  Description 


FILE  NAME:  SRVCD2 

PURPOSE:  SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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NTM/SERV  Include  File  Description 


FILE  NAME:  SRVCDS 

PURPOSE:  SERVICE  CODES  FOR  THE  NTM  SERVICE  ROUTINES. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  10/06/83 
MODIFIED  11/02/83 
MODIFIED  1/09/84 

MODIFIED  1/26/84 

MODIFIED  2/07/84 
MODIFIED  5/24/85 


TO  INCLUDE  INITEX-RES-NOT-AVAIL . 

TO  INCLUDE  WHTHST-  CODES. 

TO  CHANGE  ERROR  CODES  TO  PIC  X(5)  AND  TO 
ELIMINATE  ALPHA  CHARACTERS. 

TO  ADD  SERVICE-SUCCESS  (GENERIC)  AND 
GETUSR-NOT-SUCCESSFUL . 

TO  ADD  ERROR  CODES  FOR  ENTRY -NOT-FOUND. 
CLEAN-UP . 


PS  620142300 
1  November  1985 


NTM/SERV  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET -CODE -5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET -CODE  FOR  GETUSR-NOT-SUCC 
SRV- SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY-NOT-FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 
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NTM/SERV  Include  File  Description 


FILE  NAME:  TSTMDE 
PURPOSE:  SPACES  OR  0. 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above. 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
number  mentioned.  A  number  in  a  box  with  a  routine  name  points 
to  the  page  where  the  routine  is  further  defined  within  the 
hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  am  external  routine. 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4.1  Introduction  and  Definition* 

"Test inf  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advanoe  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  prooess  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  notioeable  to  the 
programmer  and  the  user .  In  other  words .  as  much  error 
cheoking  as  is  practical  and  possible  in  each  routine  should  be 
performed. 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assuranoe  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  prooess.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem 
areas  before  they  become  coded  "bugs . " 
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